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Section 1 


INTRODUCTION 


The 4027 Color Graphics Terminal belongs to the class of machines popularly known as 
“smart terminals.” It is a computer terminal that carries communications between the 
operator and a host computer. In addition, the 4027 contains its own microprocessor and 
supporting electronics. With this electronics, the 4027 responds to its own set of 
commands, independently of the host computer. 


The 4027 is not intended to be a stand-alone computing system. Rather, its computing 
ability complements that of the host computer, enabling the user to make full use of the 
4027’s information display capabilities. 


ABOUT THIS MANUAL 


The purpose of this manual is to acquaint you with these capabilities and to describe in 
detail the commands to which the 4027 responds. You can then use the full potential of 
the 4027 for problem solving and information display. 


Two assumptions are made concerning the reader of this manual. First, the person should 
be familiar with computer operations in general and with at least one programming 
language. Second, the person should have access to the 4027 Operator’s Manual. 


The 4027 Programmer's Reference Manual is organized along broad functional lines. 
Section 1 gives an overview of the 4027 Color Graphics Terminal. Each succeeding 
section explores one class of commands related to a basic terminal function. 


An alphabetical Command List is included following the list of Tables to provide an easy 
means of locating the various commands in this manual. Also, Appendix J is ап 
alphabetical command list which includes additional information. 


The 4027 has a variety of parameter settings, most of which are set by command, and the 
action of other commands may be influenced by these settings. When this is the case, 
commands are cross-referenced. 
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RELATED DOCUMENTATION 


Information related to programming for the 4027 can be found in the following 
documentation: 


4027 Color Graphics Terminal Operator's Manual 
4010801-4010805 Plot 10 Easy Graphing Software documentation 


А 4027 Programmer's Reference Guide, containing a summary of information in this 
manual, is also available. 


The 4027 can be used in a polling environment. For information related to polling, see the 
4020 Series Polling Reference Manual. 


THE 4027 COLOR GRAPHICS TERMINAL 


The 4027 Color Graphics Terminal (Figure 1-1) is an interface between the terminal 
operator and a host computer. It is designed especially for creating color graphic 
displays, including a variety of character fonts, in 64 different colors. In addition, it may be 
used for applications involving text editing and display and processing of forms. 


The 4027 consists of a display unit and a keyboard attached to the display unit by a thin 
cable. The display unit contains a 13 inch, refresh-style color cathode ray tube (crt), a 
microprocessor with supporting electronics, and a standard RS-232 interface. The 
terminal operator types information on the keyboard. Information from both the keyboard 
and the host computer is displayed on the crt. 


4027 terminal operations are controlled by the microprocessor and its associated 
firmware (programs for the microprocessor which are stored in Read Only Memory chips, 
or ROMs). With this firmware, the 4027 responds to several dozen commands, 
independently of the host computer. These commands determine settings of the 4027 
system parameters, control the screen display, and perform various functions useful in 
applications programs. 


4027 Features 


ө Workspace and Monitor — Тһе 4027 display memory can be divided into two 
portions (or scrolls). One portion, called the workspace, serves as a composition 
area for creating color graphics, editing text, filling out forms, or displaying the 
results of applications programs. The monitor portion of memory stores messages 
to and from the computer and any 4027 commands typed on the keyboard. 
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ө Split Screen — The 4027 screen сап be divided into two areas or windows, 


corresponding to the two portions of the display memory. The upper area is the 
workspace window and displays information from the workspace. The lower area 
is the monitor window and displays information from the monitor without writing 
over the workspace display. The portions of the screen allotted to each of these 
windows are set by command. 


Color Graphics — The 4027 can store and display graphs and a variety of 
geometric shapes in the workspace. Solid lines and several types of dashed lines 
can be drawn. АП graphs, shapes, and lines сап be displayed іп any of 64 colors. 


Color Display — The 4027 can display up to eight of it's palette of 64 colors at one 
time. Eight colors are assigned to color numbers CO-C7. If other colors are 
desired, the colors set by each of the color numbers may be changed by using the 
MAP, RMAP, or MIX commands. 


Visual Enhancements — Characters can be displayed with the standard (CO) 
attribute (white on black background) or on one of six other colors on a black 
background. In addition, the characters may be inverted (black characters on a 
colored background). Characters may also blink between colors, or between 
inverted and noninverted. In addition, various combinations of characters and 
background colors may be defined by the operator to provide an even wider 
variety of attributes. Screen contrast is controlled manually by the operator but 
screen brightness is internally set. 


Scrolling — When either the workspace window or the monitor window is full, 
information in that window scrolls up to display additional information. Infomation 
scrolled off the screen is saved as long a memory is available; the scrolled text 
may be reviewed by scrolling down. 


Forms — The workspace can display a form. When the operator has filled in the 
blanks of the form, the data in these blanks can be sent to the computer with a 
single command. 


Locally or Remotely Controllable — Commands to the 4027 can be typed on the 
keyboard or sent from the computer. 


Programmable Operating Parameters — Various operating parameters (such as 
parity, workspace margins, tab stops, etc.) can be set by commands given either 
from the keyboard or from the computer. 


Programmable Baud Rate — The 4027 baud rate can be set by command. 
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Buffered Operation — In buffered mode, a line of text (up to 80 characters) in the 
monitor is saved for proofing or local editing before it is sent to the computer. 


Programmable Keyboard — Almost all of the keys on the keyboard can be 
programmed to generate a different character or character string than the default 
one. This allows commonly used character strings or commands to be generated 
by pressing a single key. 


Local Text Editing — Using the editing keys or commands, one can edit text held 
in the workspace before sending it to the computer. 


Status Messages — The 4027 can display status messages which indicate 
parameter settings, the command character, and the amount of unused memory in 
the terminal. 


Modules — Display unit and detached keyboard. The keyboard can be located up 
to eight feet from the display unit. 


Optional Features 


е Printer Copies — Text in the workspace or in the computer сап be copied ona 


Tektronix 4642 Printer. The printer cannot copy graphics. 


Hard Copies — The 4027 can make permanent copies of all information on the 
screen using a Tektronix 4632 Hard Copy Unit. The 4632 Video Hard Copy Unit 
with Option 6 (Enhanced Gray Scale) will copy forms and graphs just as they 
appear on the 4027 screen (substituting gray scale for color). 


Additional Graphics Memory — Standard graphics memory is 48K. Options 
provide 96K, 144K, or 192K total graphics memory. 


Additional Display Memory — Standard display memory is 8K. Options provide 
either 16K or 32K bytes total display memory. 


Optional Interfaces — Options allow the 4027 to use a 20 mA current loop or an 
RS-232 peripheral communications line. A polling interface allows the terminal to 
operate as one of several "slave" display stations which communicate with the 
computer through a polling controller. 


GPIB Interface — The 4027 can communicate with four Tektronix 4924 Digital 
Cartridge Tape Drives and two Tektronix 4662 Interactive Digital Plotters, using a 
GPIB (General Purpose Interface Bus). 
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е Half Duplex — A half duplex optional interface is available. With this option the 
DUPLEX command is added to the terminal command set. 


е Alternate Character Fonts — The Math Characters font provides a variety of 
symbols useful in mathematical applications. A number of fonts containing 128 
characters each may be assigned by the user for graphics or other purposes. 32 
fonts are available, of which 30 may be user defined. 


е Rulings — The Ruling Characters font provides a variety of ruling characters. 
Using this font, the 4027 can draw horizontal and vertical rulings to highlight the 
structure of a form displayed in the workspace. 


@ Polling Controller — The 4027 can actasa “polling controller’ to supervise 
communications between several 4027 or 4024/4025 “slave display stations” 
and a host computer, using IBM 3270-Bisynchronous EBCDIC protocol. 


THE SPLIT SCREEN: WORKSPACE AND MONITOR 


Information sent to the display unit from the keyboard or the computer is stored in a part 
of the terminal’s memory called the display list. This display list can be divided into two 
sections or scrolls — the workspace scroll (or simply workspace) and the monitor scroll 
(or simply monitor). 


Information from the keyboard can be directed into either scroll, as can information from 
the computer. Each scroll has specific uses, and the 4027 processes information in the 
workspace differently than it processes information in the monitor. 


The workspace serves as a composition area. The operator can use it to create text to 
send to the computer, to edit text, to create graphics, to create or fill out forms, or to 
display results of applications programs. Text typed into the workspace is stored there 
until the terminal is commanded to send data in the workspace to the computer. Data is 
not transmitted as it is typed. 


The monitor is used to display commands typed on the keyboard and messages to and 
from the computer. The monitor cannot contain forms or graphics. In general, the monitor 
allows (1) the operator to communicate with the terminal or the computer, and (2) the 
computer to issue error messages or prompts, without this information being written over 
the contents of the workspace. 


There is always a monitor defined; hence there is always a monitor window of at least one 
line. There may, however, be no workspace defined. If no workspace is defined, there is no 
workspace window; the entire screen is devoted to the monitor. 
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Figure 1-2. The Split Screen; Workspace and Monitor Scrolls. 
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When the terminal is powered up ог RESET (using the reset button оп the back panel), the 
monitor window occupies the entire 34 lines of display, no workspace is defined, and text 
from the keyboard and text from the computer are directed into the monitor. Appropriate 
commands to the 4027 define a workspace, select the number of lines in each window, 
and direct text from the keyboard and text from the computer into the desired scrolls. 


NOTE 


If the command character is not known, pressing the shift STATUS key 
displays the command character, whether the terminal is in buffered or 
unbuffered mode, and the number of blocks of display memory available. 
The command character must be known so that commands may be given 
to define the workspace and monitor regions of the display. If the 
workspace and monitor areas have not been defined, text will not appear 
on the screen. 


С 
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For each scroll there is а cursor — a pointer in the display list indicating where the next 
character entered in the scroll will be stored. The cursor appears on the screen as a 
bright underline one column wide. Only one cursor will be visible at a given time. (There 
may be brief periods, while the terminal performs certain routines, when neither cursor is 
visible.) 


If the workspace window is full and additional text is entered in the workspace, the 
workspace automatically scrolls up to display the new text. Text scrolled off the screen is 
saved in the display list so long as that memory capacity is not exceeded. The operation 
of the monitor is similar, except that information scrolled off the monitor window will be 
discarded if that memory space is needed for other purposes. 


ал 二 1 二 一 二 


Scrolling commands and scrolling keys roll the workspace and monitor up and down， 
independently, to display various portions of text. 


一 二 一 


THE 4027 KEYBOARD 


П The 4027 keyboard is shown іп Figure 1-3. 


20. 2 


1 2657-1 


1 Figure 1-3. Тһе 4027 Keyboard. 
П As indicated іп Figure 1-3, the keys on Ше 4027 keyboard fall into three categories: 
^s ASCII keys, cursor/numeric pad keys, and function keys. 
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АЗСИ Keys 


The ASCII section of the keyboard resembles an 
ordinary typewriter keyboard. Each key in this 
section, except the BREAK key, sends a character 
of the ASCII code to the computer. (See the ASCII 
Code Chart, Appendix B.) The BREAK key sends a 
break signal which interrupts the computer’s opera- 
tion. 


Cursor/Numeric Pad Keys 


The cursor/numeric pad is the group of 11 keys to 
the right of the ASCII section of the keyboard. This 
group of keys functions either as a cursor pad or as 
a numeric pad. 


When the NUMERIC LOCK function key is off 
(unlighted), the group functions as a cursor pad. In 
this mode the four keys marked with arrows move 
the cursor and the two keys marked with triangles 
scroll the display list. If the terminal has been given 
the ENABLE command, the four keys marked with 
arrows move the crosshair in the direction indicated. 
The zero/crosshair (0/+) key and the ENABLE com- 
mand may be used to ENABLE the crosshair on the 
4027. The remaining pad keys have no effect. 


When the NUMERIC LOCK function key is on 
(lighted), the group functions as a numeric pad, 
generating the digits O - 9 and the decimal point 
(period). The shifted versions of the appropriate pad 
keys still move the cursor and scroll the display list. 


ASCI! KEYS 


E. C. 


ТТТ 
ТТЦ || 
ГГ B 
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аала | 
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SCROLLING KEYS 


NUMERIC LOCK |: 


NUMERIC KEYS 
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Function Keys 


Тһе function key group consists of the ERASE Кеу, 
the РТ (Pad Terminator) key, and the sixteen keys 
along the top of the keyboard. 


The ERASE key is at the extreme upper left of the 
ASCII section of the keyboard. This key erases 
whichever scroll (workspace or monitor) receives 
text from the keyboard. 


The PT (Pad Terminator) key is the large key to the 
right of the cursor/numeric pad. The default defini- 


tion of this key is “undefined.” 


The sixteen keys along the top of the keyboard are 


divided into four groups of four keys each. Each key in 


the rightmost group includes an LED which, when 


lighted, indicates the key is “оп.” These sixteen keys 


have the following definitions. 


F1 — Undefined 

F2 — Undefined 

ЕЗ 一 Undefined 

F4 — Undefined 

F5 — HOME 

F6 — Undefined 

F7 — Undefined 

F8 — SEND ** 

F9 — DELETE CHARACTER 

F10 — DELETE LINE 

F11 — ERASE & SKIP 

F12 — INSERT LINE 

F13 — INSERT MODE * 

F14 — TTY LOCK * 

F15 — NUMERIC LOCK/LEARN * 
F16 — COMMAND LOCKOUT/STATUS * 


* — lighted keys 
** — The SEND key has no definition until 
programmed. 
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Function keys F1-F4 and F6-F8 have default definitions of "undefined"; these keys cause | 
no action unless they are programmed. 


Function key F5 is the HOME key. Pressing this key returns the visible cursor to its | 
“поте” position in row 1, column 1 of its scroll. 


Function keys F9-F16 perform the functions indicated by their keyboard labels. These 
keys are discussed in detail in the 4027 Operator’s Manual. 


The default definition of the SEND key is "undefined." Since the 4027 command set | 
includes two different types of SEND commands, the shifted and unshifted versions of the 
SEND key may be programmed, each with a different type of SEND command. | 
Тһе LEARN key is the shifted version of the NUMERIC LOCK key. The STATUS key is the 
shifted version of the COMMAND LOCKOUT key. Neither the LEARN nor the STATUS key | і 
is a lighted key; each operates independently of the corresponding unshifted key. B 


The action of the DELETE CHAR, DELETE LINE, INSERT LINE, INSERT MODE, and LEARN | 
keys сап be duplicated by 4027 commands discussed later in this manual. 

There are no 4027 commands which correspond exactly to the HOME, ERASE & SKIP, | 
TTY LOCK, NUMERIC LOCK, COMMAND LOCKOUT, ог STATUS keys. The action of the VY \ 


HOME, ERASE 4 SKIP, and COMMAND LOCKOUT keys сап be duplicated by certain 
command sequences discussed in later sections of this manual. There are no command | 
sequences which duplicate the action of the TTY LOCK ог NUMERIC LOCK keys. 


|| 
МОТЕ 


In а 4027 which contains а Polling Controller (Option 11), the definitions 
assigned to some of the function keys will be different than those 

discussed in this section. Refer to the 4020 Series Polling Reference | 
Manual for relevant details. \ 
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Programmable Keyboard 


Most of the keys on the 4027 keyboard can be programmed with definitions other than 
the default ones. This allows the operator to generate commonly used character strings, 
commands, or command sequences by pressing a single key. 


All of the keys on the keyboard can be programmed except the following six keys. 


Ф The rightmost three lighted function keys — TTY LOCK, NUMERIC LOCK, and 
COMMAND LOCKOUT. (Neither the shifted nor the unshifted versions of these 
keys can be programmed.) 


е The three ASCII keys — SHIFT, CTRL, and BREAK. 


Key programming can assign different definitions to the shifted and unshifted versions of 
the same key. For example, the upper case A key and its unshifted version, the a key, may 
be programmed with different definitions. 


Function keys F1-F4, F6-F8, and the PT (Pad Terminator) key have no definitions 
assigned to them. These keys are reserved specifically for programmed definitions. The 
SEND key (function key F8) is usually programmed with some version of the SEND 
command. 
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4027 COMMAND STRUCTURE 


HOW TO FIND COMMANDS IN THIS MANUAL 


The 4027 responds to several dozen commands. This manual is organized functionally. 
Each command, with a description of its structure and what it does, is listed in the 
appropriate section of the manual: the UP and DOWN commands are described in 
Controlling the Display, the HRULE and VRULE commands in Forms and Form Fillout, and 
so forth. The first section in which a command appears contains a complete description of 
the command syntax. 


If the presence of certain modes or settings affects the action of the command, these 
effects are discussed in the relevant section. The TAB command, for example, causes a , 
different action when the terminal is in form fillout mode, and the action of TAB in form 
fillout mode is discussed in the Forms and Form Fillout section. 


2 


In addition to these command descriptions, Appendix J is a convenient alphabetical 
listing of commands and additional information. Also, following the Table list in the 
Contents section is an alphabetical list of commands including the section and page 
where each command is found. 
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THE FORMAT OF 4027 COMMANDS 


Each 4027 command is represented by an English-style ASCII string. In addition to the 
English-style commands, the 4027 graphics commands have counterparts on existing 
4010 Series terminals and PLOT 10 software. When these commands are sent from the 
computer, they can be represented using the 4010-style codes. 


A 4027 command consists of four parts: 
е The command character 
@ The command keyword 
Ф The command parameters 


ө The command terminator 


The command character is a unique, user-selectable character that does not normally 
occur in text. This character informs the 4027 that the information which immediately 
follows is a command. The exclamation point (!) is selected as the command character 
before the 4027 is shipped from the factory. The operator or programmer can change the 
command character by using the COMMAND command. (See Selecting the Command 
Character later in this section.) The exclamation point (!) is used as the command 
character throughout this manual. 


The command keyword is a single word that identifies the command to be executed. This 
keyword can be spelled out entirely or, if it contains more than three letters, it can be 
truncated to the first three letters. Two exceptions are the DISCONNECT and DISABLE 
commands which each require four letters. The keyword must immediately follow the 
command character; no spaces or other characters are allowed between the command 
character and the keyword. 


The command parameters, if any, follow the keyword. The type and number of parameters 
depend on the particular command; some commands take no parameters at all. 
Parameters can be numbers, character strings, or words. A parameter word can be 
abbreviated to its first letter. 


Parameters which are characters or character strings must be separated from the 
keyword and from each other by separators. A separator can be a comma or one or more 
spaces. The separator between a numeric parameter and the keyword or between a 
numeric parameter and neighboring alphabetic parameters can be omitted. 


@ 4027 PROGRAMMER'S 


( 4 


С 


C C 


С 


СОММАМО 5ТВИСТЏВЕ 


2 


Тһе last character т а command, whether а parameter ог the final character of the 
keyword, is separated from subsequent information by a command terminator. A 
terminator can be a semicolon, a carriage return, or another command character. If the 
command is the final string on a line of text, then the terminator is a carriage return. И the 
command is followed by text, a semicolon terminates the command and separates it from 
the text. If the command is followed by another command, then the command character of 
the following command can serve as the terminator. 


Figure 2-1 illustrates the format of 4027 commands. 


IBELL<CR> (NO PARAMETERS) 


一 一 一 一 一 一 一 


COMMAND 


КЕУМ 
СНАВАСТЕВ ORD TERMINATOR 


! BAUD 1200,2400 «CR» 


7 Г ЗАО ООО ОНИ 
СОММАМО EN 
CHARACTER i ES TERMINATOR 


SEPARATOR SEPARATOR PARAMETER 


KEYWORD PARAMETER 


(KEYWORDS ABBREVIATED; 


! "C 20 K ! | МАН 195 „ТО UNNECESSARY SEPARATORS 


Зи TERMINATOR OMITTED) 


TAE i M 
KEYWORD Res ы 


СОММАМО РАНАМЕТЕН5 ABBREVIATED SEPARATOR 
CHARACTER (SEPARATORS KEYWORD (NECESSARY) 
OMITTED) 


COMMAND 
CHARACTER 
(SERVES AS 

TERMINATOR) 


Figure 2-1. Command Format. 
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Consider the following line in Figure 2-1. 

МОН 20 H; THIS IS THE WORKSPACE!MON H!IBEL «CR» 
Тһе; terminates the 'WOR Н command. Тһе! of the !BEL command terminates the MON 
H command. The «CR» terminates the !BEL command and the entire line. The string 


THIS IS THE WORKSPACE, since it is not preceded by a command character, is treated 
as text and printed in the workspace. 


Separators followed by + signs can be omitted. The command 
IRVE --5,0,-20,-110,--35,-110<СНВ> 

may be written 
IRVE+ 5,0,—20,—110+ 35,—110« CR» 


The separator between -- 5 and O cannot be omitted. The separators followed by — signs 
cannot be omitted. 


Delimited ASCII Strings 


Some of the 4027 commands accept delimited ASCII strings as parameters. A delimited 
ASCII string consists of any string of printing ASCII characters with a delimiter at each 
end of the string. The delimiters mark the beginning and the end of the delimited string. 


The characters which can be used as delimiters are shown in Figure 2-2. 


-(ипдег | ine) 


· (period) 


2402-4 


Figure 2-2. String Delimiters. 


The symbol currently used as the command character cannot be used as a delimiter. The 
hyphen (—), space, semicolon (;), and comma (,) cannot be used as delimiters (although 
their shifted versions can be used), since these symbols have special uses in 4027 
command syntax. 
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The same symbol must ре used for both delimiters of a string. You may write 


ILEARN F1 [!SEND MOD;[<CR> 


but not 


{LEARN F1 [ISEND MOD;] «CR» 


The delimited string must not contain its own delimiter. To set the end-of-line string to the 
ASCII string жжж/ж, for example, we could write 


IEOL жжж/ж «CR». 
Neither the * nor the / may be used here as a delimiter. 
Some commands restrict the length of a delimited string. In general, a delimited string 
should not contain the command character (except in the LEARN command). See the 


individual command descriptions for details. 


Continuing a Command 


ПШР Ши» ШИ» Ши» | 
2 


Commands typed from the keyboard тау be continued to the next пе by simply typing 
beyond the end of the current line and allowing the command or parameter string to “wrap 
around” to the next line. 


Some 4027 commands sent from the host require a continuation character when 
commands are continued from one line of code in the host program to the next line of 
code. This is discussed in the Host Programming for the 4027 sections. 


= Шакен» apes | 
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THE SYNTAX OF COMMAND DESCRIPTIONS 


The 4027 command descriptions which appear in this manual use the following 
conventions: 


ө The exclamation point (1) is always used as the command character. 


е In a keyword or parameter string which can be abbreviated, the necessary part of 
the string is written in uppercase; the optional part is written in lower case. For 
example, 


STOps 


means that any of the strings STO, STOP, or STOPS can be used as the keyword 
in a STOPS command. Usually the choice will be STO for efficiency or STOPS for 
readability. 


е Expressions in angle brackets, <... >, are parameter names (except the 
expression « CR», which always means carriage return). When a command is 
given, the parameter name is replaced by one choice from a specified set of valid 
replacements. The set of valid replacements for the parameter name is listed or 
described. The DLINE command, for example, is described in this way: 


ж 


IDLIne [<count>]<CR> 
where <count> is a positive integer. 


Ф Optional parameters or parameter names are enclosed in square brackets. In the 
DLINE command noted above, 


Е Е. ЕК 


[< соип! >] 


means that the <count> parameter тау or тау поі be specified. Default values 
are given for all optional parameters. 
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е Whenever а list appears, with the members of the list separated by vertical bars, 
( | this means that one element is to be chosen from the list. For example, the 
FORM command syntax reads: 


IFORm [ Yes|No ] CR» 


This means that either Yes or No may be specified, but not both. Neither of these 
have to be specified. The notation Yes means that Y, YE, and YES are all valid 
parameter names and define the same command; likewise for No. Thus, 

IFOR «CR», !IFOR Y «CR», !FORM YES«CR», IFORN«CR», and !IFORM 
NO < Сп > аге all valid commands. 


ә The carriage return, « CR», is always used as the command terminator when a 
single command is listed. In particular, in the command descriptions, < CR» 
always terminates the command. 


SELECTING THE COMMAND CHARACTER 


When the 4027 is shipped from the factory, it recognizes the exclamation point (!) as the 
command character. The command character can be changed by the computer or the 
operator by using the COMMAND command. The 4027 remembers its command character 
even when it is RESET or powered off. The only way to change the 4027's command 
character is to give the COMMAND command. 


э 一 


Whenever the terminal receives the command character, it tries to interpret the 
information immediately following as a command. If this information is not intended to be 
a command, confusion may result. Therefore, the command character must be selected 
with care. It should not interfere with normal printing of text or terminal/computer 
communications. | 


Symbols such as carriage return, line feed, ог space, which are normally 
used during communications between the 4027 and the computer, should 
NOT be used as command characters. 


a oe MENS. | 


-а 


Тһе command character may vary from one applications program to another. п а text- 
editing program the exclamation point (!) would be a risky choice for the command 
character, since this symbol is occasionally used as a punctuation mark. Another symbol, 
perhaps # or @, should be chosen. 
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COMMAND STRUCTURE 


At the end of a program the command character should always be reset to the 
exclamation point. In this way, the next user will know the proper command character and 
be able to command the terminal as needed. If this has not been done, the command 
character may be found by pressing the shift STATUS key and observing the display on 
the screen. 
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СОММАМО Соттапа 


Тһе COMMAND command is used to select а new command character. 


Syntax 
ICOMmand «character» «CR» 


where «character? is a single ASCII character or a two- or three-digit ASCII Decimal 
Equivalent (ADE) of an ASCII character. 


Action 


This command sets the command character to the symbol designated by « character». If 
« character» is a single numeral, that character is the new command character. If 

« character» is a two- or three-digit numeral, that numeral is the ADE of the new 
command character. 
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Examples 


ICOMMAND X«CR» Sets the command character to the number sign (#) whose 


ICOMX «CR» ADE is 35. 

(СОМ 35 «CR» 

СОМ 8« CR» Sets the command character to the ASCII character 8. 
сом 08< CR» Sets the command character to the ASCII BS (backspace) 


character, whose ADE is O8. 
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REPORT Соттапа...........................................................1 3-11 
SEND Соттапда............................................................. 3-8 
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Section 3 


HOST PROGRAMMING FOR THE 4027 


This section discusses how to use programming language statements to communicate 
with the 4027. Application programs for the 4027 can be written in any programming 
language which can display alphanumeric information on the terminal screen and accept 
data from the terminal. 


TEXT AND COMMANDS 


All information received by the 4027, whether sent from the computer or typed on the 
keyboard, can be divided into two categories: commands and text. A command causes the 
4027 to modify its internal status in some way — perhaps to select а new command 
character, to redirect text from the computer, etc. Text is information which is printed 
verbatim on the terminal screen. 


The 4027 distinguishes between text and commands by the presence of the command 
character. When the 4027 receives the command character, it assumes a command 
follows and tries to process incoming data as a command. When not processing a 


command, the 4027 treats information as text and displays it in the appropriate text 
window. 


COMPUTER-TO-4027 COMMUNICATIONS 


Any programming statement which sends alphanumeric data can be used to send text 
and commands to the 4027. Common examples are the PRINT statement in BASIC, the 
WRITE statement in FORTRAN or PASCAL, and the DISPLAY statement in COBOL. 
Suppose we are programming in BASIC. The BASIC statement 

100 PRINT “!WOR 20 К” 


creates a workspace of 20 lines and directs text from the keyboard into the workspace. 
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NOTE 


МОВ 20 К. This < CR» serves as the command terminator. 


When the PRINT statement is executed, the computer sends a « CR» after || 
In contrast, the BASIC statement | 


200 PRINT “WOR 20 К” 


causes the text WOR 20 K to be displayed in whichever scroll receives text from the | 
computer. The command character in line 100 makes the difference; it indicates to the 
4027 that the information which follows is a command. 


Suppose you wish to initialize the 4027 by establishing a 20 line workspace to receive 
text from the computer, signal the operator by printing the message THIS IS THE 
WORKSPACE in the workspace, and ring the terminal bell. The BASIC statement 


C 


100 PRINT "МОН 20 H K;THIS IS THE WORKSPACE!BEL” | 
causes the following events: 
е The 4027 receives the first !, signaling that a command follows. 
Ф The 4027 recognizes the string WOR 20 H K; as a valid command and executes it. 
е The 4027 receives the string THIS IS THE WORKSPACE. As long as the terminal 
does not see the command character, it treats incoming information as text and 
prints it in the workspace, which now receives text from the computer. 
@ The 4027 receives the second !, signaling that another command follows. | 
е The 4027 receives the string BEL, followed by the <СН> sent Бу the computer at 


the end of the PRINT statement. The 4027 recognizes the BEL<CR> а5 а valid || 
command and executes it. 


When the 4027 receives information from the computer, it processes that information as it L 
is received. Consider the example: 

ТОО PRINT "МОВ 20 H K;THIS IS THE WORKSPACE!BEL” L 
| 
њи 
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The 4027 executes the 'WOR 20 Н К; command as soon the ; is received, while 
continuing to receive information from the computer. The information THIS IS THE 
WORKSPACE, since it is not a command, is sent to the workspace as soon as the МОВ 
20 H K; command has been executed. When the terminal receives the « CR» it executes 
the !IBEL« CR» command. 
In contrast to this, suppose the following line is typed on the keyboard: 

МОВ 20 H K;THIS IS THE WORKSPACE!BEL < CR» 
No information is processed until the < CR» is typed. Then the line THIS IS THE 


WORKSPACE is displayed in the workspace. If the line came from the host it would be 
displayed in the monitor. 


Sending Numeric Parameters 
Consider the 4027 VECTOR command: 
МЕС 100,100 200,100 150,200 100,100 < CR» 
In BASIC, this command can be sent to the 4027 in any of the following ways. 
1. Include the VECTOR command parameters as alphanumeric data in the PRINT 
statement: 


495 PRINT "МЕС 100,100 200,100 150,200 100,100" 


(The PRINT statement provides its own « CR». This «CR» terminates the 
VECTOR command.) 


2. Send the VECTOR command parameters as data. 
495 РАМТ “ІУЕС”;100,100,200,1 00,150,200,100,100 


З. Define, by host programming, BASIC variables Х1 =1 00, Х2=150, Х3=200, Y1— 
100, and Ү2--200. Then use the BASIC statement 


495 PRINT "IVEC';X1,Y1,X3, Y 1X2, Y2,X1, Y1 


This method is most versatile, since the values of the variables can be modified 
by input from the 4027 operator or by the program itself. 


The 4027 graphic commands are discussed in detail in the 4027 Graphics section. 
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Continuing a Command 
Some 4027 commands can be continued from one line of code in the host program to the 


next line of code by inserting a continuation character at the end of the line. There are two 
cases where this can be done: 


е ina VECTOR, RVECTOR, POLYGON, RPOLYGON, PATTERN ог SYMBOL 


command, the ampersand, 8, сап be inserted after a parameter to continue the 
command to the next line, provided that the only characters separating the 
command lines are the ampersand followed by « CR» or the ampersand followed 
Бу < СВЛ Е>. The BASIC statement 


100 PRINT “!POLYGON 0,0,175,175,0,175,0,0" 
can be written as two lines of code: 


100 PRINT "IPOLYGON 0,08" < CR» 
101 PRINT “175,175,0,175,0,0” <CR> 


For 4027 instruments with version 1.2 firmware: in addition to the ampersand, the 
parentheses may be used to allow for interline characters that some host systems 
insert between lines. In this case, the ampersand is followed by left parenthesis, 
&(, then a series of characters which may include < CR» , DC1, etc., then right 
parenthesis,), to resume the command. The BASIC statement 


100 PRINT "IPOLYGON 0,0,175,175,0,175,0)0" 
can be written as two lines of code: 


100 PRINT “!POLYGON 0,0&(“... interline characters ... 
101 PRINT “%)175,175,0,175,0,0” < CR» 


€ in a command which takes а delimited ASCII string as a parameter, the delimited 
string can be divided into two delimited strings on two consecutive lines of code 
using the hyphen (—) as a continuation character. For example, the BASIC 
statement 
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200 РАМТ "ILEARN F1 /ISEND АШ ЕВА W/13” 
can be written as two lines of code: 


200 PRINT “!LEARN F1 /!SEND ALL/- " 


П 201 РАМТ “ЛЕВА М//1 3" 
П The line of text to be continued іп this way should МОТ be divided between the 
command character and the keyword, within the keyword, within a numeric 
1 parameter, or between а number and its plus ог minus sign (if the sign is present). 
Commands typed from the keyboard may be continued to the next line by simply 
typing beyond the end of the current line and allowing the command or parameter 
1 string to “wrap around” to the next line. 
individual commands may tolerate minor variations in syntax. See the command 
1 descriptions for details. 


2 


А Note on Invalid Commands 


Since not all programs run correctly the first time, some information is in order concerning 
what to expect from the 4027 when it receives data which confuses it. 


When the 4027 receives an invalid command (that is, a string preceded by the command 
character but which the 4027 cannot recognize as a command), the results depend on the 
origin of this invalid command. In the following examples the command keyword STOPS is 
misspelled STEPS: 
1. Suppose the invalid command 
ISTEPS 20 40 60<CR> 


is sent from the computer in the BASIC PRINT statement 


100 PRINT “!STEPS 20 40 60” 
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The 4027 treats this invalid command as text and prints the entire string, ! 
ISTEPS 20 40 60, in whichever scroll receives text from the computer. 


When the invalid command 
ISTEPS 20 40 60<CR> 


is typed on the keyboard, an error message is printed and the invalid command 
is repeated: 


WHAT? 
ISTEPS 20 40 60 


This calls the operator’s attention to the source of the error. 


Suppose this same invalid command is part of a sequence of commands sent 
from the computer as in the following BASIC statement: 


100 РАМТ “ЕНА WISTEPS 20 40 60!BEL” 


The 4027 erases the workspace, prints the text ISTEPS 20 40 60 in whichever 
scroll receives text from the computer, and rings the bell. No error message is 


given; whatever the terminal cannot recognize as a command is treated as text. 


If the sequence of commands 
ЕВА WISTEPS 20 40 60!IBEL« CR» 


is typed on the keyboard, all information preceding the invalid command is 
processed. Then an error message, the invalid command, and the remainder of 
the line are all printed in the monitor: 


WHAT? 
ISTEPS 20 40 60!BEL 


If the 4027 receives a command that requires workspace and no workspace is defined, 
the command is ignored. Nothing will be executed and no error message will appear. 
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Displaying a Command File 


How does one display a file containing 4027 commands so that it can be read, modified, 
or debugged? There are two ways this can be done: 


The 4027 operator can press the COMMAND LOCKOUT key and then display 
the file on the screen. When this key is lighted, the 4027 treats all information, 
including the command character, as text and prints it in the appropriate scroll. 


Press COMMAND LOCKOUT (LED comes on). 
: (Display file containing ! as the command 


: character, review and edit this file, and 
: return edited file to the computer.) 


Press COMMAND LOCKOUT again (LED goes off). 
The operator or the computer can change the command character to a symbol 
which does not appear in the file to be reviewed. In a file which does not contain 
the symbol #, one might have 
СОМ #<CR> (Change command character to #) 

: (Display file containing ! as the command 


: character, review and edit this file, and 
: return edited file to the computer.) 


#COM ! (Reset command character to !.) 


The 4027 can also stay execution of commands by using the 4027 COPY command (see 
the Peripherals section). 
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4027-TO-COMPUTER COMMUNICATIONS 


There are three ways to send information from the 4027 to the computer: type into the 
monitor, use the SEND command, or use the REPORT command. 


Typing into the Monitor 


One way to enter information into the computer is to type it into the 4027 monitor. И the 
4027 is in unbuffered mode, information typed into the monitor is sent to the computer 
character by character, as it is typed. If the 4027 is in buffered mode, information typed 
into the monitor is sent to the computer line by line, as each line is terminated by a 
carriage return. Buffered and unbuffered modes are discussed in more detail in the 
System Status and Initialization section. 


SEND Command 

A second way to send information to the computer is to first enter that information in the 
4027 workspace. When the operator or the computer gives the SEND command, all the 
information in the workspace is sent to the computer. 


Syntax 


ISENd «CR» 


This command causes all information in the 4027 workspace to be sent to the computer. 


Usually the SEND key is programmed to give the SEND command, so that the operator 
can send the workspace contents to the computer, simply by pressing the SEND key at 
the appropriate time. 


The SEND command is used in conjunction with whatever input request statement is 
available in the programming language. In BASIC, for example, the INPUT statement is 
used; in COBOL, the ACCEPT statement is used. 


NOTE 


The key labeled SEND on the 4027 keyboard is NOT pre-programmed. It 
may be programmed to give the SEND command using the LEARN 
command or the LEARN key. 
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The following program asks the operator to type а one-line message іп the workspace and 
press a key to send this message to the computer. When the computer receives the 
message, it prints it back in the monitor, so that the operator can verify the message was 
correctly received. 


ха 二 Же 


LIST 

NONAME 09:09 АМ 25-Apr-78 

100 REM---CREATE A CLEAN WORKSPACE 

110 PRINT ’!WOR 20 K’ 

120 REM---PROGRAM SEND KEY (FUNCTION KEY 8) TO GIVE !SEND COMMAND 
130 PRINT " ЦЕН F8/!SEND/13 10” 

140 REM---INFORM OPERATOR 

150 PRINT ''MON H’ 

160 PRINT 'This program accepts a message from the 4027 Workspace’ 
161 PRINT ’and verifies the message was received. When you type your’ 
162 PRINT ’message, it appears in the workspace. When you press the’ 
163 PRINT 'SEND key, your message is sent to the computer. Тһе computer ' 
164 PRINT ’verifies your message by printing it back to you, in the’ 
165 PRINT 'monitor. Nou type your message and press the SEND key uhen' 
166 PRINT 'ready. ' 

200 REM---ACCEPT INPUT FROM TERMINAL 

21@ INPUT AS 

220 REM---SEND MESSAGE RECEIVED BACK TO TERMINAL 

238 PRINT ’Your message was received. It read:’ 

248 PRINT 

258 PRINT AS 

268 PRINT 

270 PRINT 

999 END 
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NOW IS THE TIME 


This program accepts a message from the 4027 Workspace 

and verifies the message was received. When you type your 
message, 14 appears іп the workspace. When you press the 
SEND key, your message 1s sent to the computer. The computer 
verifies your message by printing it back to you, in the 
monitor. Now type your message and press the SEND key when 
ready. 

* 

Your message uas received. It read: 


NOW IS THE TIME 


NOTE 


When the SEND command is given from the computer, it must be placed in 
the applications program before the input request statement. In BASIC, for 


example, write 


100 PRINT “ISEND” 
110 INPUT A$ 


Do not write 


200 INPUT A$ 
210 PRINT "ISEND" 


In the latter case, the program never executes line 210. It halts at line 200, 


waiting for data which never comes. 


The use of the SEND command in form fillout applications is discussed in the Forms and 
Form Fillout section. 
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REPORT Command 
A third way to send information to the computer is for the computer to issue the REPORT 
command to the 4027. 
Syntax 
IREPort «device» «CR» 


where «device» is an integer from OO to 14. 


Action 


This command causes the 4027 to send a report to the computer. The report has the 
following format: 


IANS «device», « data Пеја >; 


The report identifier ANS (for *answer") is followed by one space, the two-digit «device» 
number, then а comma, then the «data field», and finally a semicolon. 


The «data field» parameter contains one or more fields, separated from each other by 
commas. The format of «data field 2 depends on the value of «device» ; that is, on the 
device reporting. For a given device, however, the format of < data field is always the 


same. This allows the applications program to correctly extract data from < data field, 
knowing which device was interrogated. 


Examples 
1. Thecommand 


IREP 00< CR» 


causes the 4027 to report the system status block to the computer. This report 
is in the following format: 


IANS O0, «p1»,«p2»; 
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where 


<p1> ва four-digit decimal number specifying the number of unused blocks 
of memory. (A block consists of 16 8-bit bytes.) 


<p2> is a three-digit number representing the decimal equivalent of a binary 


number which specifies the system status byte. The numbers which may be 
displayed and the condition they represent are: 


004 — monitor present (always true). 
005 — monitor present, buffered mode. 
006 — monitor present, form fillout mode. 


007 — monitor present, form fillout mode, buffered mode. 


The command 
ВЕР 01 « CR» 


causes the 4027 to report the status of the alpha cursor within the workspace 
to the computer. If no workspace is present, all zeros are returned. This report is 
in the following format: 


IANS 01,<p1>,<p2>,<p3>; 
where 


<p1> is a three-digit decimal number specifying the row of the workspace in 
which the cursor is located. 


<p2> is a three-digit decimal number specifying the column of the workspace 
in which the cursor is located. 


<p3> is a single character, the character displayed at the cursor position. 
If the cursor is located under an alternate character, such as rulings, the 
alpha character representing that position is transmitted. If it is located 
under a graphics cell, any one of the 128 ASCII characters may be 
transmitted. 
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The command 
(ВЕР 02 «CR» 


causes the 4027 to report the position, color, and shrink factor of the graphic 
beam. This report is in the following format: 


IANS 02,« data 1>, «data 2», «data 3», «data 4»; 
where 


« data 1» is a three-digit decimal number which indicates the current x- 
coordinate of the graphic beam position. 


«data 2» is a three-digit decimal number which indicates the current y- 
coordinate of the graphic beam position. 


« data 3» is a three-digit decimal number preceded by C or P which indicates 
the current color (CO-C7) or pattern number (PO-P1 19). 


«data 4» is a three-digit number indicating the current shrink factor. The 
number may be: 


001 — 4010 


002 - hardcopy 
003 = both 4010 and hardcopy 


NOTE 


Hardcopy shrinking is not necessary on the 4027, but is included for 4025 
compatibility. 
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4. The command 
{REP OS «CR» 


Causes the 4027 to report the status of the crosshair; whether it is present and 
its position. This report is in the following format: 


!АМ$ 03, «data 1>, «data 2», «data 3»; 
where 


« data 1> is a three-digit decimal number that indicates whether the crosshair 
is visible (000 is off, 001 is оп, 002 is оп in 4010 mode). 


« data 2» is a three-digit decimal number that indicates the current x- 
coordinate of the crosshair. 


«data 3» is a three-digit decimal number that indicates the current y- 
coordinate of the crosshair. 


[一 


The REPORT command can be used for purposes other than straightforward interrogation 
of {һе system status block, {Пе workspace сигзог, graphic beam information апа 
crosshair positioning. 


4 


Аз ап example, suppose the applications program is sending large amounts of data to the 
4027 at relatively high baud rates. It is possible for the computer to overrun the 4027's 
input buffer, resulting in loss of information. Occasionally inserting the pair of statements 
(here in BASIC) 


XXX PRINT “!REP ОО” 
XXX+1 INPUT A$ 


causes the program to pause at each input statement and not continue until it receives 
input for AS (that is, until the 4027 has processed its entire input buffer and ANSwers the 
REPort command). This prevents the program from sending more data to the terminal until 
the terminal has processed its input buffer. What the terminal ANSwers is not important, 
only that it ANSwers. 
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The REPORT command is also used to obtain information about peripherals which may be 
attached to the 4027. Details are contained in the Peripherals section. Appendix E 
contains a program segment in PASCAL to illustrate how the input from a REPORT 
command can be processed. 


Listed below is a summary of the REPORT command <device> numbers and the devices 
they reference. 


Device number: Reports: 
po" PT system status block 
站 alpha cursor information 
(0207: D e dar Em ua s e ТІС graphic beam information 
Oc CC TC E crosshair information 
Әр opor te ele t t e tape unit 1 
ОВ ои ТКИ tape unit 2 
OG p кои боца ea ier ee И С ote oat ТОЕ tape unit 3 
О EL MEM tape unit 4 
ОВ. алате ол аи и mere UN ERN reserved 
О vett teo at VIE: reserved 
ТО ӨЕ ЛКК bd tec СЕ ees reserved 
m EIL reserved 
Та orco ad oreste Eti e se Parte РОО plotter 1 
13236 v tenders Detlev tL met m ete plotter 2 
Tb s oio села o т мае қабы printer 
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Section 4 


PROGRAMMING THE KEYBOARD 


The 4027 keyboard is programmable; that is, most of the keys can be programmed to 
generate a character or string of characters other than the default ones. When a key is 
programmed, the new definition assigned to that key is stored in the 4027 RAM (Random 
Access Memory). If the terminal is RESET or powered off, the definition is lost and the key 
reverts to its default definition. 


Key programming enables the operator to give a command or sequence of commands by 
pressing a single key. During an applications program the operator can log on or log off 
the computer, change terminal parameters, send information to the computer, page 
through text, or perform any of several convenient functions just by pressing a key. Key 
definitions may be part of terminal initialization or may occur at convenient points in a 
program. A key can have several different definitions in a single program. 


The user can also use the LEARN command to define sixteen macros (M1-M16). Macros 
are command or text strings defined in the same way as programmed keys. However, а 
тасга 1$ not executed by depressing any key. Instead, a macro is executed when the 
EXPAND command is received from the host computer or the keyboard. 


All the keys on the 4027 keyboard can be programmed except the following six keys: 
е The rightmost three lighted function keys — TTY LOCK, NUMERIC LOCK/LEARN, 
and COMMAND LOCKOUT/STATUS. (Neither the shifted nor the unshifted 


versions of these keys can be programmed.) 


e The SHIFT, CTRL, and BREAK keys. 


PROGRAMMING A KEY 


A key may be programmed with a new definition in one of two ways: 
€ The operator may use the LEARN key. 
е The operator or computer may give the LEARN command. 


The LEARN key performs the same action as the LEARN command. The 4027 Operator's 


Manual describes the use of the LEARN key. 
| 
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LEARN Command 


Syntax 
ILEArn «key» [<string>]<CR> 
where 


<Кеу> designates the key or macro to be programmed. 


« string» designates the character or character string to be assigned to the 
designated key. 


С 


Action 


D 


This command redefines the key or macro designated by the <Кеу> parameter; 
whenever this key is pressed or macro called, it generates the character string defined by 
<string>. 


E. 


Range of Parameters 


С 


Тһе <Кеу > parameter may Бе апу of the following: 
€ A single printing ASCII character. 


€ A two- or three-digit ADE (ASCII Decimal Equivalent) value from OO through 127, 
inclusive. (See the ASCII Code Chart Appendix B.) 


€ A mnemonic representing a non-ASCII key (function key or cursor/numeric pad 


key): 
F1 —F12 Function keys 1 through 12 
$1 — 812 Function keys 1 through 12 with SHIFT 
depressed 
РО — P9, P., PT Numeric pad keys and Pad Terminator key 
е М1 — M16 Internal macros 1 through 16 set by giving 


с E E C C C 


the LEARN command from keyboard or host. 
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П LEARN COMMAND 
ие 
П € А "psuedo-ADE value” representing a non-ASCII key: 
128 Function Key 1 144 SHIFT-Function Key 1 
n 129 Function Key 2 145 SHIFT-Function Key 2 
: 130 Function Key 3 146 SHIFT-Function Key 3 
131 Function Key 4 147 SHIFT-Function Key 4 
П 132 Function Key 5 148 SHIFT-Function Key 5 
| 133 Function Key 6 149 SHIFT-Function Key 6 
134 Function Key 7 150 SHIFT-Function Key 7 
n 135 Function Key 8 151 SHIFT-Function Key 8 
136 Function Key 9 152 SHIFT-Function Key: 9 
137 Function Key 10 153 SHIFT-Function Key 10 
П 138 Function Key 11 154 SHIFT-Function Key 11 
139 Function Key 12 155 SHIFT-Function Key 12 
П 140 Function Key 13 156 SHIFT-Function Key 13 
160 Pad Key 0 172 ERASE 
161 Pad Key 1 173 SHIFT-ERASE 
162 Pad Key 2 174 BK TAB 


163 Pad Key 3 
164 Pad Key 4 
165 Pad Key 5 
166 Pad Key 6 
167 Pad Key 7 
168 Pad Key 8 
169 Pad Key 9 
170 Pad Key. 
171 Pad Terminator Key 


5 


The <string> parameter may be any of the following: 
е One ог more ADE values 
@ One or more pseudo-ADE values 
@ One or more delimited ASCII strings 
@ Any combination of the above 
If the <string> parameter is omitted, the key is assigned its default meaning (the 


standard keyboard meaning). The <string> parameter may be any length as long as the 
terminal’s display memory capacity is not exceeded. 


2 
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Examples 


ILEARN # /(End-of-Page)/<CR> 
ILEA 35 /(End-of-Page)/ « CR» 


НЕА 35 18 CR» 


ILEA F8 "ISEND МОО: 13« CR» 
НЕА 135 “ISEND MOD; 13« CR» 


Redefines the # key (SHIFT-3 key), whose 
ADE is 35, to generate the parenthetical 
comment (End-of-Page). The definition of the 
3 key is unchanged. 


Redefines the # key to mean carriage 
return. 


Programs function key F8, whose pseudo- 
ADE is 135, to give the ISEND MOD com- 
mand. 


НЕА 148 /IWORIERA W;READY FOR NEXT PROGRAM/ 7 7 7 /IMON;/183« CR» 


ILEA 148« CR» 


Programs the SHIFT-HOME key, whose 
pseudo-ADE is 148, to direct text from the 
keyboard into the workspace, erase the 
workspace, print the message READY FOR 
NEXT PROGRAM there, ring the terminal bell 
three times, and return the keyboard to the 
monitor. 


Restores the SHIFT-HOME key to its default 
meaning (undefined). 


ILEA M1/The rain in Spain falls mainly on the plain./ « CR» 


Programs macro M1 to print the delimited 
string. M1 may be invoked by giving the 
EXPAND M1 command from the keyboard or 
the host computer. 


ILEA M16/!IRVE 0,0 20,0 0,100 —10,—50/ 13 «CR» 


Defines macro M16 to be the specified RVEC- 


TOR command. 


ILEA F1/!RMAP C2 30,—25,—50/ 18 «CR» 
ILEA 128/!RMAP C2 30,—25,—50/ 13 «CR» 


@ 


Defines function key F1 to the specified RMAP 


command. 
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PROGRAMMING THE KEYBOARD 
LEARN COMMAND 


NOTE 


When programming а key to give а command or sequence of commands, 
always include the ADE 13 as the last character of « string» (outside the 
delimiters). This insures that pressing the programmed key causes the 
command(s) to be executed. 


Special Considerations 


When the LEARN command is given from the computer, it may be continued from one line 
of program code to the next by using a hyphen (—) as a continuation character. This 
causes the next <CR>, up to one <LF>, and all NULs, RUBOUTs, апа SYNCs to be 
ignored until another character is received. The LEARN command 


ILEA ЕЗ /THIS COMMAND IS TOO LONG TO FIT ON ONE LINE./ 13« CR» 
can be written on two consecutive lines of BASIC program code as follows: 


100 PRINT “!LEA F3 /THIS COMMAND IS TOO /-" 
101 PRINT "/LONG TO FIT ON ONE LINE./ 13" 


This does not apply to a LEARN command entered from the keyboard. If the command is 
entered from the keyboard, one simply continues typing until the command is complete. If 
the command is longer than one line (80 characters), the cursor wraps around to the next 
line; the command is not terminated until < CR» is pressed. 


Since delimited strings may contain only printing ASCII characters, any control 
characters or non-ASCII characters included in a LEARN command must be encoded 
using ADEs or pseudo-ADEs outside the delimited string. Thus, the command 


НЕА $ 13 10€ CR» 

programs Ше $ key (SHIFT-4 key) to mean «CR» «LF». In contrast, the command 
ILEA $ /13 10/« CR» 

programs the $ key to print the ASCII string 13 10. 


If one of the ASCII numeral keys (0-9) or the period key ( . ) is programmed, the 
corresponding numeric pad key (with the NUMERIC LOCK key lighted) is also 
programmed. Likewise, if the numeric pad key (with NUMERIC LOCK on) is programmed, 
the corresponding ASCII numeral or period key is programmed. Programming an ASCII 
key does not program the corresponding cursor pad key with NUMERIC LOCK off. 
Likewise, programming the cursor pad key with NUMERIC LOCK off does not program the 
АЗСИ key marked with the same symbol. 
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If the character string assigned to a programmed key includes опе or more commands, 
those commands are executed but not displayed on the screen when the programmed key 
is pressed. 


The <string> parameter may include the CLEAR command, discussed later in this 
section. Suppose we program the F1 function key as follows: 


ILEARN F1 ЛЕВА M!CLEAR!BEL; Goodbye for now.!MON/13<CR>. 


Pressing F1 causes all of the commands to be executed and the text "Goodbye for now." 
to be printed in the workspace, even though the CLEAR command is given early in this 
string. The string wil! be executed only the first time the key is pressed. 


Function key pseudo-ADE's can be included in the «string» parameter, but those ADE's 
generate default definitions instead of previously programmed definitions. Consider the 
command sequence: 


ILEARN 172 ЛЕВА WIBEL/13« CR» 
ILEARN 128 172 « CR» 


The first LEARN command programs the ERASE key (pseudo-ADE 172) to erase the 
workspace and ring the bell. the second LEARN comand programs function key F1 to 
mean the same as the unprogrammed ERASE key. 


NOTE 
The SEND keys (keys F8 and S8, with pseudo-ADEs 135 and 151, 
respectively) have no meaning until programmed. Normally, these keys will 
be programmed to give the SEND ALL or SEND MOD command, or some 
command sequence which sends information to the computer. 


Macros and the EXPAND Command 


The EXPAND command is used to execute macros which were defined by the LEARN 
command. 
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EXPAND COMMAND, LEARN AND COMMAND 


EXPAND Command 
Syntax 
IEXPand «macro no.» «CR» 


where « macro no.» is a macro пате (M1, M2, . . . , M16). 


Action 


This command is used to invoke any macros specified by the LEARN command. EXPAND 
may be given by the keyboard or the host computer. Thus, a command or series of 
commands or a string may be sent by the host or the operator by giving the EXPAND 
command. 


Example 
IEXPand M1«CR» 


causes the string assigned to the given macro (M1) to be inserted in the input queue in 
place of the EXPAND command. Macros are numbered M1 through M16. 


The LEARN Command and the COMMAND Command 


Do not confuse programming a key using the LEARN command and selecting a new 
command character using the COMMAND command. These operations are different. 


Programming a key with the LEARN command causes the programmed key to generate a 
different character or character string than it normally generates. In contrast to this, 
selecting a new command character does not change the character string generated by 
any key. Rather, it changes the way the 4027 processes the default symbol generated by 
one particulr key. The same key generates the same symbol, but that symbol, when seen 
by the terminal, now has a different effect. 


When the COMMAND command selects a new command character for the 4027, this new 
selection is stored in the 4027 battery-maintained RAM. This means that the 4027 
remembers the new command character, even when it is turned off or RESET. The only 
way to change the 4027's command character is to give a new COMMAND command. 
When a key is programmed using the LEARN command, however, the learned definition is 
lost if the terminal is turned off or RESET, and the key returns to its default definition. 


4027 PROGRAMMER'S @ 4-7 


PROGRAMMING THE KEYBOARD 
KEYBOARD LOCKOUT 


4-8 


KEY PROGRAMMING AND KEYBOARD LOCKOUT 


When a key is programmed, the new definition assigned to that key is generated 
whenever the key is pressed; however, the default character assigned to that key can still 
be sent to the terminal. It is not the default character, but the key itself, which generates 
the new definition. 


Suppose we execute the following sequence of commands: 
ILEA 127 ЗАЦЕА 34 /!'WOR 20 Н K/13<CR> 


The RUBOUT key (ADE 127) is now programmed to mean quotes (4) and the quotes key 
(ADE 34) is programmed to mean WOR 20H K« CR». The ASCII quotes character сап 
be sent to the terminal with its usual meaning, either by sending the ASCII quotes 

character (ADE 34) from the computer or by pressing the RUBOUT key on the keyboard. 


| may be desirable to prevent an operator from issuing arbitrary commands to the 
terminal during an applications program, but still allow him to issue certain specific 
commands or command sequences. During a form fillout program for example, the 
operator should not be able to modify the form itself, but should be able to give the SEND 
MOD command. 


Key programming can accomplish this. Suppose ! is the command character. If the 
computer sends the command 


ILEARN 33 00 « CR» 


to the 4027, the ! (SHIFT-1) key is programmed to generate the ASCII NUL character. This 
prevents the operator from using the ! key to generate the command character. Yet the 
computer can send command characters to the terminal and can program function keys 
to issue commands when pressed by the operator. Only the operator's ability to issue the 
command character arbitrarily from the keyboard is impaired. At the proper time, the 
computer returns control of the 4027 to the keyboard by sending the command 


ILEARN 33« CR» 


This returns the ! key to its default meaning. 
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CLEARING KEY DEFINITIONS 


То restore a single key to its default definition or to clear macro definition, use the LEARN 
command with the <string> parameter omitted. The command 


ILEARN «key» «CR» 


will restore the «key key or macro to its default meaning. 


CLEAR Command 


To clear all programmed key definitions and all macro definitions simultaneously, use the 
CLEAR command. 


The command 


ICLEar «CR» 


clears all key and macro definitions generated by LEARN commands or by the LEARN 
key. АП keys revert to their default definitions; all macros become undefined. 
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COMMANDS DISCUSSED IN THIS SECTION: 


Terminal Status Commands 


COMMAND Соттапа.................................. 
FORM Соттапа....................................... 
MARGINS Соттапа................................... 
MONITOR Соттпапа................................... 
SNOOPY Соттапа.................................... 
STOPS Сотпапа...................................... 
WORKSPACE Command ............................... 


Communication Status Commands 


BAUD Соттапа....................................... 
BUFFERED Соттапа.................................. 
DELAY. Gonmimand.x c а ees тақты xa 
DISCONNECT Соттапа............................... 
DUPLEX Command .................................... 
ECHO Соттапа eile hel e D ELE ER CC Ee 
EOF (End-of-File) Соттапа............................ 
EOL (End-of-Line) Соттапа........................... 
FIELD Соттапа....................................... 
PARITY Соттапа..................................... 
PROMPT Соттапа.................................... 


Additional Commands 


ОТЕТ Соттапа...................................... 
TEST Command ....................................... 
SYSTAT Command .................................... 
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Section 5 


SYSTEM STATUS AND INITIALIZATION 


The 4027 has many operating parameters which can be set from the keyboard or from the 
computer. This allows the 4027 to interface with a variety of host systems, as well as run 
many different applications programs easily and effectively. Some of these parameters 
(the end-of-line string, for example) must be set when the terminal is first installed and 
are changed infrequently, if at all. Other parameters (the form fillout mode setting, for 
example) will be changed more often, perhaps several times within the same program. 


Clearly, it is necessary for the host and the applications program to be well informed of 
the status of these parameters. Since these settings may be changed from the keyboard 
without the host's knowledge, the first task of any applications program is to initialize the 
terminal; that is, the terminal must be set to a known and desired state which facilitates 
execution of the program. When the program is completed, the terminal should be 
returned to a known reference state for the convenience of future users. 


Some parameters affect the status of the terminal itself. Other parameters affect the 
status of communications between the terminal and the host computer. This section first 
discusses the terminal status commands which determine the status of the terminal itself. 
These are the COMMAND, WORKSPACE, MONITOR, MARGINS, STOPS, FORM, SNOOPY, 
and PAD commands. Then the communication status commands which determine the 
status of communications between the 4027 and the host computer are discussed. These 
are the BUAD, PARITY, ECHO, BUFFERED, EOL, PROMPT, DELAY, FIELD, EOF, DUPLEX, 
and DISCONNECT commands. 
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TERMINAL STATUS COMMANDS 


COMMAND Command 


The syntax of the COMMAND command is 


{COMmand «character» « CR» 


where «character» is a single printing ASCII character or the ADE (ASCII Decimal 
Equivalent) of an ASCII character. The syntax and action of this command were 
discussed in the 4027 Command Structure section; however, some additional comments 
regarding terminal initialization are in order here. 


Since each command to the 4027 must be preceded by the command character, the 
computer must know the command character at all times. Although the terminal operator 
can discover the command character by pressing the STATUS (SHIFT-COMMAND 
LOCKOUT) key, the computer cannot do this. Therefore, at the end of each applications 
program the command character must be set to a reference symbol. This insures the next 
user proper access to the terminal. The exclamation point (!) is recommended as the 


reference symbol. It is the command character when the 4027 is shipped from the factory. 


It is also used as the command character throughout this manual and throughout the 
4027 Operator's Manual. 


The command character can be changed at the beginning of an applications program, or 
anytime during the program, by using the COMMAND command. But the program should 
always reset the command character to the reference character, !, before releasing 
controi of the terminal. Consider a text-editing program. Since the ! symbol is used 
occasionally as a punctuation mark, one may wish to avoid using it as the command 
character in this situation. Such a program might begin by choosing another command 
character, say the Ф character, and resetting to ! at the end of the program: 


соме «CR» 
(Body of program) 


Q9 COM!«CR» 
End of execution 
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WORKSPACE Command 


When the 4027 is powered up or RESET, there is no workspace or workspace window, the 
entire 34-line screen is devoted to the monitor window, and text from both the keyboard 
and the computer is directed into the monitor. Before an applications program is run, the 
4027 terminal screen must be initialized: 


е Divide the screen into a workspace window and a monitor window to display 
information from the corresponding scrolls. 


ө Direct text from the computer and from the keyboard into the appropriate scrolls. 


One of the commands used to initialize the screen is the WORKSPACE command. 


Syntax 


!WORkspace [<number >] | Host | [Keyboard ] «CR» 


where <number> is an integer between 0 and 33, inclusive. 


Action 


If «number» is included, this command erases the entire display list (the monitor, and if 
a workspace is defined, the workspace also). The terminal then defines a workspace and 
allots the top <number> lines of the screen for the workspace window. The remaining 
34-<number> lines are used for the monitor window. At least one line is always reserved 
for the monitor window. 


If H (Host) is specified, text from the host computer is directed into the workspace. If K 
(Keyboard) is specified, text from the keyboard is directed into the workspace. 
(Commands typed on the keyboard are still displayed in the monitor.) 
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If only the <number> parameter is specified, text from the keyboard and text from the 
computer go to the same scrolls as before. AWORKSPACE 0 command directs text from 
both the keyboard and the computer into the monitor, since this command destroys the 


workspace. 


If no parameters are specified, and the command comes from the host computer, а 
WORKSPACE H command is executed. If no parameters are specified and the command 
is typed on the keyboard, a WORKSPACE K command is executed. 


Examples 


IWOR 20H K«CR» 


МОН 25 < CR» 


МОН 0<CR> 


IWOR H«CR» 


IWOR«CR» 


Erases the display list, reserves the top 20 lines of the 
screen for the workspace window, and directs text 
from both the computer and the keyboard into the 
workspace. 


Erases the display list, reserves the top 25 lines of the 
screen for the workspace window. Does not change 
the destination of text from the computer or of text 
from the keyboard. 


Erases the display list, reserves the entire 34-line 
screen for the monitor window. Directs text from both 
the computer and the keyboard into the monitor, since 
no workspace is defined. 


Directs text from the computer into the workspace. 
Does not erase the workspace or change the position 
of the workspace cursor. 


If this command comes from the computer, it directs 
text from the computer into the workspace. If the 
command comes from the keyboard, it directs text 
from the keyboard into the workspace. 


а 4027 PROGRAMMER'S 


c 


Е 


CZ 


C EL 


22222 -3 


23 3 


Т 


STATUS/INITIALIZATION 
MONITOR COMMAND 


MONITOR Command 


The WORKSPACE command does not allow you to specify which devices (Host, 
Keyboard) send information to the monitor. The MONITOR command allows you to do this, 
as well as create text windows. 


Syntax 
IMONitor [<number>] | Host] | Keyboard ]<CR> 


where «number» is ап integer between 1 and 34, inclusive. 


Action 


If «number» is included, this command erases the entire display list (the monitor, and if 
a workspace is defined, the workspace also). The terminal then defines a workspace and 
reserves the top 34-<number> lines of the screen for the workspace window. The 
remaining <number> lines are used for the monitor window. At least one line is always 
reserved for the monitor window. 


If H (Host) is specified, text from the computer is directed into the monitor. If К (Keyboard) 
is specified, text from the keyboard is directed into the monitor. 


If «number» is the only parameter specified, text from the computer and from the 
keyboard go into the same scrolls as before. AMONITOR 34 command directs text from 
both the computer and the keyboard into the monitor, since this command destroys the 
workspace. 


If no parameters are specified and the MONITOR command comes from the host 
computer, a MONITOR H command is executed. If no parameters are specified and the 
MONITOR command is typed on the keyboard, a MONITOR K command is executed. 


Examples 
IMON 10 H K<CR> Erases the display list, creates a monitor window of 10 
lines and a workspace window of 24 lines, and directs 
text from the computer and from the keyboard into the 
monitor. 
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IMON 34<CR> 


IMON H<CR> 


IMON<CR> 
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Erases the display list, creates a monitor window of 4 
lines and a workspace window of 30 lines. Text from 
the keyboard and text from the computer go into the 
same scrolls as before. 


Erases the display list and reserves the entire 34 lines 
of screen for the monitor window. Directs text from 
both the computer and the keyboard into the monitor, 
since no workspace is defined. Equivalent to a WORK- 
SPACE 0 command. 


Directs text from the computer into the monitor; does 
not erase either scroll. 


If this command comes from the computer, it directs 
text from the computer into the monitor. If the com- 
mand comes from the keyboard, it directs text from the 
keyboard into the monitor. 
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MARGINS Command 


Workspace margins are set with the MARGINS command. (Monitor margins are always 
set to columns 1 and 80, and cannot be changed.) 


Syntax 
IMARgins [<left>] [<right>]<CR> 


where <left> and <right> are integers between 1 and 80, inclusive, and <left> is less 
than <right>. If only one parameter is specified, it is taken to be the <left> parameter; 

in this case, the <right> parameter remains unchanged. If both parameters are omitted, 
« left» and «right» default to 1 and 80, respectively. 


Action 


This command sets the workspace margins — the left margin to column «left» and the 
right margin to column «right». 


When the terminal receives a « CR» from the computer or from the keyboard, the cursor 
moves to column «left». АП cursor movement keys and almost all commands which 
move the cursor respect the left margin: if the left cursor key is pressed repeatedly, the 
cursor moves left to column « left», then wraps around to column 80 of the previous line; 
the BACKTAB key does not move the cursor past column «left». (The one exception is 
the JUMP command. See the Controlling the Display section.) 


If a character is typed into column < пай! >, the terminal Бей rings. This is the only action 
which occurs. ІТ more characters are entered in the workspace, those characters are 
displayed on the same line, and the cursor continues moving right until either (1) the 
cursor moves past column 80 and wraps around to the next line, or (2) the terminal 
receives a « CR» as a signal to begin a new line. In either case, the cursor moves to the 
left margin in column «left of the next line. 


Exampies 


IMARGINS 10 70« CR» Sets the left workspace margin to column 10 and the 
right margin to column 70. 
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IMAR 25<CR> Sets the left margin to column 25; leaves the right 
margin unchanged. 


IMAR<CR> Sets the left and right margins to their default settings: 
columns 1 and 80, respectively. 
The 4027 remembers its right and left margins when it is powered off or RESET. 
NOTE 


Unless stated otherwise, it is always assumed in this manual that the left 
margin is set to column 1. 
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STOPS Command 


Tab stops are set with the STOPS command. 


Syntax 

ISTOps [«stop 1>] [<stop 2>]...[<stop 16>]<CR> 
where each <stop n> parameter is a positive integer between 2 and 80, inclusive, and 
parameters are arranged in increasing order. 
Action 
This command sets up to 16 tab stops by listing the columns in which stops are defined. 
Stops are defined in both the workspace and the monitor simultaneously. Only the stops 
specified are defined; all previous stops are deleted. Stops may be set to the left of the 
left workspace margin, to the right of the right workspace margin, and between the 


margins. 


If no parameters are specified, all tab stops are cleared. 


Examples 
ISTO 10 20 35 45 60<CR> Defines monitor and workspace tab 
stops in columns 10, 20, 35, 45, and 60. No other 
stops are defined; any previously defined stops are 
deleted. 


ISTO<CR> Clears all tab stops. 


The 4027 remembers its tab stops when powered off or RESET. 
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FORM Command 

The FORM command places the 4027 in form fillout mode and removes it from form fillout 
mode. 

Syntax 


IFORm [ Yes|No]<CR> 


Action 
The FORM YES command (or equivalent) places the 4027 in form fillout mode. The FORM 
NO command (or equivalent) removes the 4027 from form fillout mode. A detailed 


discussion of form fillout mode is found in the Forms and Form Fillout section. 


If no parameter is specified, Y (Yes) is assumed. 


Examples 
ЕОВМ YES<CR> Places the 4027 in form fillout mode. 
IFOR Y<CR> 
|ЕОВ<СВ> 
{FORM МО < CR» Removes the 4027 from form fillout mode. 
IFOR N<CR> 


The 4027 always powers up and RESETs to FORM NO. 
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SNOOPY Command 
The 4027 has a “snoopy” mode of operation. In snoopy mode, the non-printing ASCII 
characters (control characters) are represented on the screen by two letter mnemonics. 


The RUBOUT (or DELETE) character is represented by a blotch of fine diagonal lines. 
Entering and leaving snoopy mode is controlled by the the SNOOPY command. 


Syntax 


ISNOopy [ Yes|No]<CR> 


If neither parameter is specified, Yes is assumed. 


Action 


The SNOOPY YES command places the 4027 in snoopy mode. The SNOOPY NO 
command removes the 4027 from snoopy mode. 


2 


Snoopy mode is useful for troubleshooting and debugging, since it allows the operator to 
examine all ASCII characters received by the terminal, not just printed characters. It is 
also useful for inserting control characters into text stored in the workspace. Commands 
are still executed in snoopy mode. 


To see the ASCII NUL character printed when examining incoming data, it is necessary to 
have the 4027 parity set to "data." (See the discussion of the PARITY command in this 


section.) 
Examples 


ISNOOPY YES«CR» Places the 4027 in snoopy mode. 
ISNO Y «CR» 
ISNO« CR» 


!SNOOPY NO<CR> Removes the 4027 from snoopy mode. 
ISNO N<CR> 


The 4027 always powers on or RESETs to SNOOPY NO. 
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PAD Command for the 4027 with Version 1.2 Firmware 


The PAD command is used to perform two 4027 functions, keyboard lock and delete 
ignore. Keyboard lock enables the host program to control keyboard operation and data 
entry. Delete ignore enables the delete character (ADE 127) to be cancelled when it is 
received by the 4027. 


Syntax 


ГРАО [205/203] < CR» 


Action 


The PAD 205 command places the 4027 in keyboard lock mode. With the keyboard 
locked, no data or commands may be entered from the keyboard. Any attempt to enter 
data or commands from the keyboard rings the bell. The PAD 203 command, which can be 
given only from the computer, removes the 4027 from keyboard lock mode. Keyboard lock 
mode may be exited without the computer PAD 203 command by pressing the BREAK key 
two times in rapid succession. 


Examples 


IPAD 205 «CR» Places the 4027 in keyboard lock mode. 
IPAD 203 «CR» Computer only — Removes the 4027 from keyboard lock. 
BREAK-BREAK Keyboard only — Removes the 4027 from keyboard lock. 


Syntax 


IPAD [209/207] < CR» 


Action 


The PAD 209 command places the 4027 in delete ignore mode. With delete ignore 
invoked, any delete characters (ADE 127) are cancelled as they are received by the 4027. 
This feature permits operation with computers which randomly output delete characters 
to the terminal. When operating in 4010-style graphics mode, the unwanted delete 
characters can distort the graphics display. The delete characters can also interrupt 
4027 commands if transmitted within a command string. 
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Examples 


IPAD 209 «CR» Places the 4027 in delete ignore mode. 
IPAD 207 « CR» Places the 4027 in full 128-character receive mode. 
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BAUD Command 


The simplest communications system consists of a device to transmit information, a 
device to receive information, and a communications link or “line.” The rate at which 
information is transferred over a communications line is called the "baud rate." This rate 
is given in bits/second; a baud rate of 1200 means information is transferred at the rate 
of 1200 bits/second. 


During any communication, the rate at which the transmitting device transmits information 
must be the same as the rate at which the receiving device receives it. If the host 
computer is sent data to the 4027 at 1200 baud, the 4027 must be set to receive data at 
1200 baud or greater. 


The 4027 has a "receive baud rate" and a “transmit baud rate." These need not be the 
same; i.e., the terminal may receive information at a different rate than it transmits 
information. 


The 4027 baud rates are set using the BAUD command. 


Syntax 
IBAUd «transmit» [«receive»]« CR» 
where both «transmit» and «receive» are chosen from the following list: 


(0 | 50 | 75 | 110 | 134 | 150 | 300 | 600 | 1200 | 1800 | 2400 | 4800 | 9600) 


Action 


This command sets the transmit baud rate to <transmit> and the receive baud rate to 
«receive >. A baud rate of О means a "times 1" external clock is used. 


If «receive is omitted, it is set equal to «transmit». 
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IBAU 300,1200 « CR» Sets the transmit baud rate to 300 baud and the 
receive baud rate to 1200 baud. li 
ВАШ 2400 « CR» Sets both transmit and receive baud rates to 2400 


baud. 


When the 4027 is turned off or RESET, it remembers the current baud rate. 
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PARITY Command 


In the ASCII code, each of the 128 ASCII characters is represented by а 7-bit binary 
number. When a character is transmitted, an eighth bit, called a "parity bit," is also 
transmitted. Some computers use this extra bit for error checking, some use it as a data 
bit, and some simply ignore it. 


The 4027 parity must be set to correspond with that of the computer to which it is 
connected. This is done by using the PARITY command. 


Syntax 
IPARity | Even | Ода | None | High | Data ] СВ > 


If no parameter is specified, the 4027 parity defaults to None. 


Action 


This command sets the 4027 parity. If the parity is set to Even, the terminal transmits 
characters with even parity and checks incoming characters for even parity. If the parity 
is set to Odd, the terminal transmits characters with odd parity and checks incoming 
characters for odd parity. If the parity is set to None, the terminal transmits characters 
with parity bit set to zero; the parity of characters input to the terminal is ignored. If the 
parity is set to High, the terminal transmits characters with parity bit set to one; the parity 
of incoming characters is ignored. If the parity is set to Data, the parity bit of each 
character input to the terminal is treated as data; the parity bit is set to zero on characters 
output from the terminal. Note that with parity set to data, if a character is received which 
has the parity bit set to one, it will be treated as a pseudo-ADE rather than a real ASCII 
character (since real ASCII is in the range of O to 127). Thus a parity setting of data 
should only be used if the programmer can control how the computer sets the parity bit. 


Examples 
IPAR Ec CR» Sets the 4027 to even parity. 
IPAR O<CR> Sets the 4027 to odd parity. 
IPAR N<CR> Sets parity to “попе;” the 4027 ignores the parity bit 
on input characters and sets it to zero on output 
characters. 
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IPAR H<CR> Sets parity to "high;" the 4027 ignores the parity bit on 
input characters and sets it to one on output charac- 
ters. 


г. C 


IPAR D<CR> Sets parity to "data;" the parity bit is read as a data bit 
for incoming characters and set to zero on output 
characters. 


„ВЕНИ 


Тһе 4027 remembers its parity setting when powered off ог RESET. 
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ECHO Command 


When the operator types into the monitor in unbuffered mode, there are two ways that the 
characters typed may be displayed on the screen: remote echo and local echo. 


In remote echo communications, characters typed into the monitor are sent to the 
computer without being displayed. As the computer receives each character, it “echoes” 
it back to the terminal. (In some systems, a modem may provide the echo.) It is the 
received echo, rather than the original transmitted character, that the 4027 displays on 
the screen. In remote echo communications: 


Ф As each character is typed into the monitor, the operator can tell immediately 
whether the computer has received that character correctly. 


ө Selective echo is possible. The computer can be programmed to decide which 
characters to echo. In timesharing systems, for example, the computer is usually 
programmed not to echo a user’s password. 


іп local echo communications, as each character is typed into the monitor, the 4027 
supplies its own echo. It displays each character sent to the computer without waiting for 
the computer echo. Local echo communications may be used with half duplex 
communications links, while remote echo requires full duplex communications. 

It is important that the 4027 be set for the proper echo. If the 4027 is set to remote echo 
and neither the host nor the modem provides an echo, characters typed on the keyboard 
are not displayed at all. If the 4027 is set to local echo and either the host or the modem 
also provides an echo, characters typed in the keyboard are displayed twice. 


The type of echoing which the 4027 uses is selected with the ECHO command. 


Syntax 
IECHo [Local | Remote] x CR» 


If neither L nor R is specified, L is assumed. 


Action 


This command selects the echoing used by the 4027 when text from the keyboard is 
directed into the monitor and the 4027 is in unbuffered mode. 
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Examples | 
IECH« CR» Sets the 4027 for local echo. | 
IECHL« CR» 

IECHR«CR» Sets the 4027 for remote echo. Ц 


Тһе 4027 remembers its ECHO setting, even when powered off ог RESET. 
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BUFFERED 


The terminal can operate either in unbuffered or buffered mode. These modes of 
operation differ in the way that the terminal processes information from the keyboard and 
from the computer. The terminal powers up in unbuffered mode. It remains in unbuffered 
mode until placed in buffered mode by the BUFFERED command. 


When the terminal is in unbuffered mode, each character typed into the monitor is 
immediately transmitted to the host. Under these circumstances, it is not possible to 
locally edit the information displayed in the monitor. As soon as a character appears in 
the monitor window (if in tocal echo), it is sent to the computer. Text typed into the 
workspace is not sent to the computer until the SEND command is given and executed. 
When the SEND command is executed, all the text in the workspace is sent to the 
computer in an uninterrupted stream. 


When the terminal is in buffered mode, characters entered in the monitor are stored in the 
keyboard buffer until RETURN is pressed. Anytime before RETURN is pressed, the 
current line can be edited locally. When RETURN is pressed, the terminal marks the end 
of the line and stores the line in the transmit buffer. The line remains in the transmit buffer 
until it is processed. By comparison, each line typed in the workspace is stored there and 
can be edited locally, even after RETURN is pressed. When the SEND command is given, 
the entire workspace contents are read into the transmit buffer for processing. 


The contents of the transmit buffer are processed line by line on a first-in/first-out basis. 
To do this, the terminal uses a handshaking process involving prompts (prompt strings) 
from the computer and EOL (end-of-line) strings from the terminal. 


When the computer is ready to receive data, it sends a prompt and delay to the terminal. 
When the terminal receives this prompt followed by the delay, it knows that the computer 
has finished its transmission and is ready to receive data. The terminal waits for the 
programmed delay time before transmitting. The terminal then processes the oldest (first- 
in) line in its transmit buffer. Information destined for the computer is sent there and any 
terminal commands entered from the keyboard are executed. When a line is sent to the 
computer, an EOL terminates the line. When the computer sees the EOL String, it knows 
that the terminal has finished sending a line and is waiting for another prompt or data 
from the computer. If the computer has data for the terminal, it sends this out, followed by 
a prompt; if the computer has no data but wants another line from the terminal, it simply 
sends a prompt. A more detailed description of each command and its operation follows. 


The commands which relate to buffered mode are PROMPT, DELAY, and BUFFERED. The 
PROMPT command sets the prompt string to be used by the computer to request a line 
from the terminal. The DELAY command sets the time interval between a computer prompt 
and a transmitted line, plus sets the time measured after a prompt string to assure that 
the string is actually a prompt rather than text. These two commands are described on the 
following pages under PROMPT and DELAY. 
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The BUFFERED YES and BUFFERED NO commands are used to enter and exit buffered 
mode and can be invoked either from the computer or keyboard. The effect of the 
BUFFERED commands and the sequence of buffered mode events differ depending upon 
the source of the commands, computer or keyboard. 


Syntax 
IBUFfered [Yes]< CR» from the keyboard 
IBUFfered [Yes] « CR» from the computer 
IBUFfered [Yes]; from the computer 


Yes is assumed if not specified 


Action 


The BUFFERED YES command puts the terminal in buffered mode regardless of the 
source of the command or previous buffered/unbuffered condition. If previously in 
unbuffered mode and the !BUF command is given from the keyboard, the output buffer is 
armed to send the first line placed in the transmit buffer without the need of a host 
prompt. If already in buffered mode when the keyboard !BUF command is given, there is 
no change to the original first line condition, and a prompt is required for each additional 
line in the transmit buffer. 


If the computer is the source of the ІВОҒ command, the functions are threefold. First, the 
!BUF command places the terminal in buffered mode. Second, the computer !IBUF 
command cancels any previous prompt which may have the transmit buffer in an armed 
condition. This is used prior to communication of any computer commands to prevent 
the terminal processor from attempting a transmit while in computer command mode. And 
third, the computer 'BUF command places the workspace in keyboard type-ahead. When 
the terminal is in type-ahead, keyboard characters directed to the workspace are not 
immediately displayed. Type-ahead prevents interaction between simultaneous work- 
space display of computer and keyboard information. 


When the computer is ready for the terminal to proceed, the prompt string is sent to the 
terminal. If the defined prompt string is followed by the specified DELAY time (no CR, 
NUL, SYNC, or other characters), the above condition of type-ahead is cancelled, 
releasing keyboard data to the workspace, and the transmit buffer is armed for one line. 


REV A, JUL 1980 4027 PROGRAMMER'S 


C 


C 


C 


C C GG UE 


—— 


С 


ам 
===. 


Le E 


=J 二 


二 -了 Сэ 


Зутах 
IBUFfered [Мо]< CR» 
!BUFfered [No] < CR> 
IBUFfered [No]; 


N or No must be specified 


Action 


Examples 


keyboard !IBUF« CR» 


keyboard !BUF!ISEN< CR» 


computer !IBUF« CR» 
IBUF; 


computer < prompt/delay» 


computer !BUF;« рготрИде!ау> 


CN 
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from the keyboard 
from the computer 
from the computer 


The BUFFERED NO command puts the terminal in unbuffered mode and transmits any 
lines remaining in the transmit buffer. If the keyboard is the source of the !ВУЕ N 
command, the command is placed in the keyboard buffer. (The keyboard buffer holds 
keyboard data and is separate from the transmit buffer.) If there are lines or commands in 
the keyboard buffer awaiting prompts, the keyboard !ВЏЕ М command does not execute 
until the lines or commands are prompted in sequence. If the keyboard buffer is empty, 
execution of the !ВЏЕ М command is immediate. The terminal exits buffered mode and 
transmits the remaining lines to the host. 


If the computer is the source of the !ВЏЕ М command, execution is always immediate. Тһе 
^ terminal exits buffered mode, transmits any remaining lines to the computer, and 
executes any commands waiting in the keyboard buffer. 


Places the terminal in buffered mode. If 
previously unbuffered, arms transmit buffer. 


Places the terminal in buffered mode. Sends 
the workspace to the transmit buffer. If 
previously unbuffered, transmits one line. 


Places the terminal in buffered mode. Can- 
cels an outstanding prompt. Places the 
workspace in keyboard type-ahead. 


Follows the above host command. Waits the 
delay then arms the transmit buffer. Re- 
moves the workspace from type-ahead. 


Places the terminal in buffered mode. Can- 


cels an outstanding prompt. Waits the delay 
then arms the transmit buffer. 
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computer !IBUFIJUM nn; Cancels an outstanding prompt. Directs host 
output to terminal display. 

computer « prompt/delay» Follows the above host command sequence. 
Waits the delay then arms the transmit 
buffer. Removes the terminal from type- 
ahead. 

keyboard !BUF N< CR» Exits buffered if keyboard buffer is empty. 
Transmits all lines in transmit buffer. 

computer | ВИЕ N< CR» Exits buffered mode. Transmits all lines in 


5-20-b 


IBUF М; transmit buffer. Executes any buffered key- 
board commands. 


The computer should always transmit ‘display’ command sequences (!JUM, !ATT, etc.) to 
the terminal starting with 'BUF and ending with a < prompt/delay» . This minimizes the 
possibility of keyboard entry interfering with the computer commands. Once the !ВЏЕ has 
executed, there is no chance of interaction. 


For example, use: IBUFIJUM!ATT E;ENTER!ATT S!JUM10,20; < prompt/delay> 


Computer sequences which include ‘output’ commands (ISEN, !REP, etc.) should start 
with ТВОЕ and include а < prompt/delay> prior to the output command. The computer 
should not use sequences such as !BUF!ISEN. 


For example, use: ВОЕЦОМ!АТТ Е; ЗТОР!АТТ S; <prompt/delay> !SEN; 


Initialization commands (IDEL, !PRO, 'WOR, !МОМ, !EOL, etc.) should be done prior to 
displaying computer information and entering buffered mode. A minimum of 500 
milliseconds should follow a command to set up the workspace/monitor screen (IWOR n 
H K) before sending a buffered « prompt» to the terminal. When prompting the terminal, 
the host should not send in excess of eight prompt strings within one delay time. 


Break Function 


In addition to the previously described BUFFERED NO commands, the BREAK key can be 
used to exit buffered mode. When pressed two times in rapid succession, the terminal 
exits buffered mode, cancels all data in the transmit buffer, and sends a break signal to 
the computer. BRK-BRK should be used only when it is desireable to cancel data in the 
buffers. 
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EOL (End-of-Line) Command 


When the 4027 sends information to the computer, it sends an end-of-line string at the 
end of each line of text. This end-of-line string tells the computer where one line of text 
ends and the next line begins. In buffered mode, it also informs the computer that the 
terminal has finished current processing tasks and can receive data from the computer. 
Some computers expect to see <CR> (carriage return) at the end of each line; others 
may expect to see « CR» «LF» (carriage return, line feed) or other strings at the end of 
each line. 


When the operator types text into the monitor destined for the computer, an end-of-line 
string is inserted whenever RETURN is pressed. When text from the workspace is sent to 
the computer (with a SEND command), an end-of-line string is inserted at the end of each 
line of text. (In buffered mode, as the computer requests each line of text from the 
terminal, the terminal sends that line, and inserts an end-of-line string at the end of the 
line.) The EOL command is used to set the 4027 end-of-line string. 
Syntax 

IEOL [<string>]<CR> 
where <string> may be: 

1. One or more delimited ASCII strings. 

2. Asequence of ADE values separated by spaces, or commas. 


3. Апу combination of 1 and 2. 


The end-of-line string defined by this command must not be more than ten characters in 
length. If <string> is not specified, it defaults to <CR> (carriage return). 


Action 


This command sets the end-of-line string which the 4027 sends to the computer at the 
end of each line of text. 
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Examples || 
IEOL<CR> Sets the 4027 end-of-line string to carriage return, | 
IEOL 13<СВ> «CR», with ADE 13. Ц 

{EOL 13 10<CR> Sets Ше end-of-line string to «CR» «LF». 


г. 


{EOL /** $/ 1310 < CR» Sets the end-of-line string to the ASCII string 
жжФ<СН><ІҒ>. 


The 4027 remembers its end-of-line string when it is powered off ог RESET. 
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PROMPT Command 


In buffered mode, when the host computer is ready to accept another line of text from the 
4027, it sends a prompt or prompt string as a cue for the terminal to transmit another line. 
The prompt must always be the last character(s) sent by the computer. If characters are 
received by the terminal after the prompt character(s), the terminal may assume that the 
computer is still transmitting. If there is any doubt about control characters being sent 
after the prompt, the program can be run іп SNOOPY, UNBUFFERED mode so that the 
output may be examined. Prompt strings vary with the computer and with the program; but 
the prompt to which the 4027 responds must agree with the prompt sent from the 
computer. The 4027 prompt string is set using the PROMPT command. 


Syntax 
IPROmpt [<string>]<CR> 
where <string> may be: 
1. Опеог more delimited ASCII strings. 


2. Asequence of ADE values separated by spaces or commas. 


3. Апу combination of or 2. 


The <string> parameter may not define a string of more than ten ASCII characters. 
If <string> is omitted, the prompt string is set to the line feed character, <LF>. 


Action 


This command sets the 4027 prompt string to <string>. In buffered mode, the 4027 
waits to receive <string> from the computer before processing the next line in its 
transmit buffer. 
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Examples 


IPRO /**$/<CR> 


IPRO 13 10<CR> 


IPRO /**$/13 10<CR> 


ІРВО<СН> 


Sets the prompt string to жж%. In buffered mode, the 
4027 must receive this string from the host before it 
sends a line of text from its transmit buffer. 


Sets the prompt string to <CR><LF>, with ADEs 13 
and 10, respectively. 


Sets the prompt string to ** $ CR» «LF». 


Sets the prompt string to the default setting, <LF>. 


The 4027 remembers its prompt string when RESET or powered off. 
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DELAY Command 


Sometimes it is desirable that the 4027 not respond immediately to a prompt from the 
computer. If the 4027 is executing a SEND command оп a rather full workspace and the 
сотршег 5 input buffers are small, it is possible for the 4027 transmission to overrun this 
input buffer. Information is lost and communications are garbled. 


The prompt string may be used in other ways as well. Suppose the prompt string is <LF> 
and the computer is sending a paragraph of straight text to the 4027. There will be many 
line feeds which are not intended as prompts. If the 4027 waits before responding to a 
<LF>, and another character is received, the 4027 knows to cancel the planned 
response and keep listening to the computer for more text. 


The 4027 transmission delay is set using the DELAY command. 


Syntax 
IDELay <time><CR> 


where <time> is a positive integer. 


Action 


This command sets the transmission delay to <time> milliseconds. In buffered mode, 
after a prompt is detected, the 4027 waits at least <time> milliseconds before 
transmitting anything back to the computer. 


Examples 
IDEL 20<CR> Causes the 4027 to wait at least 20 milliseconds 
before responding to a prompt from the computer. 
IDEL Oc CR» The 4027 responds immediately to a prompt from the 


computer. 


The 4027 remembers its delay time when it is RESET or powered off. 
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When the 4027, in form fillout mode, sends form fields to the host computer in a SEND 
operation, the computer must know when a new field begins. This can be arranged in two 
Ways: 


ІЗ (一 


е Fields sent to the computer аге preceded by а field separator character; each time 
the computer sees this character it knows a new field immediately follows. If a 
field has not been completely filled out, only the filled out portion of the field is 
transmitted; trailing spaces are not sent. 


е Each field is sent in its entirety, including trailing spaces. The choice of which 
method to use is determined largely by the programming language used. (See 
Forms and Form Fillout for details.) 


C=. C жеге 


The 4027 is instructed how to send form fields to the host by using the FIELD command. 


LE 


Syntax 


4 


IFIEld [<character>]<CR> 


E. 


where «character» is a single printing ASCII character, or a 2- or 3-digit ADE between 
00 and 127, inclusive. 


Е 


If no parameter is specified, it is assumed to be NUL. 


- 


DT 


Action 


CZ 


This command sets the character which precedes fields of a form when they are 
transmitted to the computer by the 4027. If no value is supplied, then no character is 
inserted before a field, and trailing spaces are sent. Common choices for the field | 
зерагаюг аге ТАВ, СВ, апа 05. 
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Examples 
IFIE@<CR> Sets the field separator to the @ character, with ADE 
ІНЕ 64<CR> 64. This character precedes each field of a form sent 
to the computer. 
IFIEc CR» When fields of a form are sent to the computer, no field 


separator is used. Each field is sent in its entirety, 
including all trailing spaces. 


The 4027 remembers the field separator when RESET or powered off. 
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EOF (End-of-File) Command (Requires Option 3 or 4) 
The 4027 can copy a file from one device to another by using the COPY command. When 
the data comes from the host, the 4027 looks for an end-of-file string to know when to 


stop the COPY operation. It also sends the EOF string to the host at the end of a copy. 


The end-of-file string is selected using the EOF command. 


Syntax 
ЕОЕ [<string>]<CR> 
where <string> consists of: 
1. One more delimited ASCII strings. 
2. A sequence of ADE values separated by spaces or commas. 
3. Any combination of 1 and 2. 


This command may not define an ASCII string of more than ten characters. If <string> is 
not specified, it defaults to /*. 


Action 


This command sets the end-of-file string. This string marks the end of a file transferred by 
a COPY command. See the Peripherals section. 


Examples 
IEOF/$ **/ c CR» Sets the end-of-file string to the ASCII string, Фжж. This 
string marks the end of a file transferred by a COPY 
command. 
ЕОЕ 27 27 T«CR7 Sets the end-of-file string to ## <ESC >. 
IEOF < CR» Sets the end-of-file string to its default value, /ж. 


The 4027 remembers the EOF setting when RESET or powered off. 
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DUPLEX Command (Requires Option 1) 
The 4027 with Option 1 may be set for either full duplex or half duplex communications. 
Full duplex mode is used with full duplex communication lines, which permit both terminal 


and host to transmit at the same time. Half duplex is used with half duplex communications 
lines, over which only one device (terminal or host) can transmit at a time. 


Half duplex communications can use either normal or supervisor mode. 
In half duplex communications, the 4027 can also be set to respond to either “line 
turnaround only” or “prompt string plus line turnaround” as the prompting condition in 


buffered mode. 


The DUPLEX command is used to set the 4027 for half duplex or full duplex 
communications. 


Syntax 
IDUPlex [<fulldup> | <halfdup>]<CR> 


where <fulldup> = Full 
<halfdup> = Half [Supervisor | Normal] [Line | Prompt] 


If no parameters are specified, full duplex operation is assumed. If half duplex is chosen, 
supervisor mode and line are the default parameters. 


Action 


This command sets the 4027 for either full duplex or half duplex communications. If half 
duplex is chosen, either Supervisor or Normal mode is chosen. Also, the prompt condition 
to which the 4027 responds in buffered mode is set to either Line (line turnaround only) 
or Prompt (prompt string plus line turnaround). 


Examples 
IDUP< CR > Sets the 4027 for full duplex. 
IDUP F<CR> 
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БОР H<CR> 
IDUP HS<CR> 
IDUP H S L<CR> 


БОР H $ P<CR> 


IDUP HN<CR> 
РОР H N L<CR> 


IDUP НМ P<CR> 


Sets the 4027 for half duplex with supervisor. In 
buffered mode the prompt condition is line turnaround 
only. 


Sets the 4027 for half duplex with supervisor. In 
buffered mode the prompt condition is the prompt 
string plus line turnaround. 


Sets the 4027 for half duplex normal. In buffered mode 
the prompt condition is line turnaround only. 


Sets the 4027 for half duplex normal. іп buffered mode 
the prompt condition is the prompt string plus line 
turnaround. 


The 4027 remembers its duplex setting when RESET or powered off. 
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DISCONNECT Command (Requires Option 1) 


л ш> B | 


Syntax 


!IDISConnect« CR» 


Action 
This command sends a signal to the modem, causing it to disconnect the 4027 from the 
communications line. (The terminal turns off the “data terminal ready" signal on the RS- 


232 interface for about one second. This causes the modem to disconnect from the 
communications line.) 


Example 


IDISC «CR» Disconnects the 4027 from the communications line. 


2 


МОТЕ 
DISCONNECT тау not be abbreviated to the first three letters (DIS) as this 
would conflict with the DISABLE command. 


BREAK Functions 


The BREAK key is used to signal an interrupt to the computer and to terminate a variety of 
local operations regarding buffered mode and peripheral functions. The effects of a single 
press of the BREAK key differ from two presses of the BREAK key as follows: 


BREAK (Version 1.2 firmware). The RS232 TDATA communication line is held active for 
350 milliseconds. Internal terminal operations are not affected. 


BREAK-BREAK. Тһе TDATA break time is 350 milliseconds’, buffered mode is exited, 


transmit and receive buffers are cancelled, keyboard lock is exited, COPY and 
DIRECTORY operations are terminated, and a multiple HCOPY command is discontinued. 


*200 msec in V1.1 


2 
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STATUS MESSAGES 


In addition to the commands which set the 4027 terminal parameters and communica- 
tions parameters, there are four "status" messages which display, on the screen, 
information about the parameter settings and internal status of the terminal. These are the 
STATUS message, the SYSTAT message, the system TEST message, and a GTEST 
(Graphic Test) message. 


The STATUS Key and The STATUS Message 


At any time, the 4027 operator may press the STATUS (SHIFT-COMMAND LOCKOUT) 
key to get a brief STATUS message. This message is displayed in the monitor, without 
disturbing the contents of the workspace. The STATUS message shows whether the 4027 
is in buffered or unbuffered mode, the command character, and the number of unused 
blocks of terminal memory. The actual number of blocks is determined by display memory 
option. (A block consists of 16 eight-bit bytes. One block holds at most 14 characters.) A 
status message is shown in Figure 5-1. 


UNBUFFERED COMMAND CHARACTER 988 BLOCKS OF 
MODE 15 44 MEMORY LEFT 


В ~ 988 


BUFFERED COMMAND CHARACTER 988 BLOCKS OF 
IS ^^^ 


MODE MEMORY LEFT 


(2401) 2657-4 


Figure 5-1. STATUS Message. 


SYSTAT and The SYSTAT Message 


The 4027 has a SYSTEM STATUS, or SYSTAT, message which lists most of the 
parameter settings discussed in this section. The SYSTAT command displays the 
SYSTAT message in the monitor. 


Syntax 


ISYStat < CR» 
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SYSTAT 

SYSTAT Parameters 

The 4027 SYSTAT message lists the following parameters, using the abbreviations 

shown. 

TB — Transmit baud rate 

RB — Receive baud rate 

DL — Delay time 

LM — Left margin 

RM — Right margin 

WL — Number of workspace lines displayed on the screen 

V# — Firmware version number 

TS — Tab stops 

сс — Command character 

FS — Field separator 

PR — Prompt string 

EL — End-of-line string 

DU — Duplex (DU —F means full duplex, DU=H means half duplex.) 

BU — Buffered mode (Y means buffered, М means unbuffered.) 

EC 一 Echo (EC = А means remote echo, EC=L means local echo.) 

FF — Form fillout mode (Y means yes, N means no) 

SN — Snoopy mode (Y means yes, N means no) 

KB — Keyboard (КВ = М means text typed on the keyboard is directed to the monitor, 
KB —W means text from the keyboard is sent to the workspace.) 

CM — Communications line (СМ--М means text from the communications line is 
directed to the monitor, CM=W means such text is sent to the workspace.) 

PA — Parity (N means none, D means data, E means even, O means odd, H means 
high.) 

CO-C7 — Color numbers CO-C7 are displayed with color samples and the HLS 
parameters for each color. 

If the 4027 contains Option 10 (Polling Interface) an additional field, PL=, appears. This 

field is followed by a two-digit decima! number indicating the polling address of this 

display station. 

If the 4027 contains Option 1 (Half Duplex) and the 4027 is set for half duplex 

communications, the DU field may contain one or two additional letters. See the DUPLEX 

command description earlier in this section for details. 
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If a parameter is set to an ASCII control character, the two-letter mnemonic for that 
character is shown in the parameter setting. The SYSTAT message is illustrated by Figure 
5-2. 


'systat 
TB- 2400 РН- 2400 Гі = 
“1813 и в и 


FS=4 РР-СІММЕ: = 


BU=N EC-R FF-M SN-N KBM 
B,100,100 C1 128, 58, 
, 54.100 ся Зия, 58,1 


Figure 5-2. The 4027 SYSTAT Message. 


C Q CC к C 


When the 4027 is turned off or RESET, it remembers some of the parameter settings in 
the SYSTAT message, and resets others to default settings. Those settings which are 
remembered are: TB, RB, DL, LM, RM, TS, CC, FS, PR, EL, DU, EC, and PA (and the PL 
setting, if present). 
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When the 4027 is powered up or RESET: 


e WL = О (There is no workspace defined.) | 
е ВЏ = М (Тһе 4027 is in unbuffered mode.) | 
е ЕЕ = М (Тһе 4027 is по in form fillout mode.) 

е SN = М (Тһе 4027 is not in snoopy mode.) U 
е KB = M and CM = M (Both the keyboard and the computer direct text to 


С 


the monitor.) 


е CO-C7 = (АП eight colors are displayed with their default HLS parameters. 
Color C7 (black) is not visible.) 


Е. 


The V# setting will not change unless а different firmware version is installed in the 
4027. 


CZ 


ми 
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TEST Command 
The command: 


ITEST<CR> 


or 


ITES<CR> 


causes the 4027 to run a program which checks whether the terminal memory and 
display are operating properly. The following actions occur: 


ө The terminal erases the entire display list and creates a 34-line monitor window. 


ө System ROM (Read Only Memory), system RAM (Random Access Memory), and 


display RAM are checked. The four system ROM checksums are displayed. An 
error in display RAM prevents a bad block of memory from being used; the number 
of free blocks is reduced, but the terminal operates correctly. 


After the memory test, the lights on the four lighted function keys are turned on, all 
128 ASCII characters are displayed in the monitor in snoopy mode, and all Font 1 
characters (ruling characters) are displayed. (If this character set is not installed, 
each of its characters is displayed as a dot matrix with every dot turned off.) 


After the two character sets are displayed, a sample of colors CO-C6 is 
represented by displaying three upper-case letter A's in each color. Color C7 
(black) is not visible. 


€ At the end of the test, the lights on the function keys are turned off and the bell is 


rung. 


Should the test reveal a failure in the system RAM, the message "RAM ERROR" appears. 
If such a message appears, call your Tektronix service personnel. 


NOTE 


Running this test destroys any text or key definitions which may have been 
stored in the 4027 memory. 


An example of the display created by a successful TEST on the 4027 is shown Figure 5-3. 
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C ee CC C C CC COC ку C 


4 141 77 44 
TASTE ER 0,05 0,0, 3 BES 


M 
PQRSTUWAXYZE -27- р hi jk седани 4. тї 
пици на неј old А ине на нии 


"4 же, == 123456789: ; < = P@ABCDEF GHITKLMING 


4141 тг 44 SYSTEM ROM 
CHECKSUMS 


FEE ES ERD 0,060, RS ВЕРА ЖЕ (1ж%,-.-2173456789:;< = > ?9BCDEF SHITELMNG 
THE 128 ASCII 
CHARACTERS IN 


PORSTUMMXYZE 1^. * abcdefghi jk Imnoparstuvwxuzt:j SHOOPONOEE 


HH нин HH HHE HH ННІ ЕН И | кови РЧ ФИНН HH ФАЦ Јо | раб. HH HHH 


RULING 
CHARACTERS 


HH НН Н | ЕНИ здания РЧ ФИН HH n Ro Бы И 


VISUAL 


| SEVEN 
ATTRIBUTES 


— Н ee —— 


一 一 一 一 一 一 
со ст C2 C3 C4 C5 C6 
(2656) 2657-6 


C 


Figure 5-3. 4027 !TEST<CR> Results. 
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СТЕЗТ Соттапа 
Тһе 4027's Graphics Memory сап Бе tested by the command: 
IGTEST<CR> 
or 
IGTE«CR» 
causes the 4027 to test its graphic memory. 


When this command is executed, the entire display list is erased and a 34-line monitor 
window is created. The terminal then tests its graphic memory. After a delay of about 15 
seconds while it performs the test, the terminal displays the test results in the monitor, 
starting with font 1 and proceeding to font 31. If no RAM is installed for a particular 
character set, the 4027 displays a “МО MEM" message. If RAM is installed, each 
character is tested twice (each bit is tested for both 1 and O). If the RAM passes the test, 
the 4027 displays “ОК” for each of these two tests. If the RAM for a particular character 
set fails the test, the 4027 displays the “ВАМ ERROR" message and an error code for use 
by Tektronix service personnel. 


A sample display of a successful GTEST is shown in Figure 5-4. 
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т 


ОМТ-- ROM Font 1 Enabled 
RAM and ROM Not Enabied 
FONT — Font 3 Епа мед 


" 


RAM апа ROM Not Enabled 


МОМА ШМ 


RAM Not Enabled 


804840404044 


ВАМ Fonts 16-31 Enabled 
and Functioning 


ВЗВЧВИЪВНЕВ 


ROM 
NO 
ROM 
NO 
NO 
NO 
NO 
NO 
NO 
NO 
NO 
NO 
NO 
NO 
NO 
ок 
OK 
OK 
OK 
OK 
OK 
OK 
OK 
OK 
OK 
OK 
OK 
OK 
OK 
OK 
OK 


i: 
| 


Figure 5-4. 4027 !'GTEST« СА > Results. 
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COMMANDS DISCUSSED ІМ THIS SECTION: 


Cursor Commands 


Scrolling Commands 


RDOWN (Roll Down) Соттапа......................... 
RUP (Roll Up) Command ............................... 


Additional Commands 


p 
го 
о 


Ге ЕР. co 


С 
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Section 6 


CONTROLLING THE DISPLAY 


Before information is displayed on the terminal screen, decisions must be made regarding 
the set-up of the screen: how the screen’s 34-line display is to be divided between the 
workspace window and the monitor window; which scroll is to receive text from the 
computer and which from the keyboard; and margins and tab stops. The commands which 
set these parameters are discussed in the System Status and Initialization section. We 
assume here that these parameters have been set. Throughout this section we assume 
the left workspace margin is set to column one. 


THE CURSOR COMMANDS 


Explanation of the 4027 will involve reference to three cursors. One, called the graphic 
cursor or crosshair, is used in the creation of graphic displays and is discussed in the 
Graphics section. This section will discuss only the other two cursors; the workspace 
cursor and the monitor cursor. Only one of these is visible at a given time. Since, in either 
window, the cursor indicates the position at which new information will be printed on the 
screen, one may wish to change the cursor position at various times. 


The programmer uses commands to position the cursor at a desired location. (The 
operator may give these same commands from the keyboard or use the corresponding 
keys.) The commands which affect the cursor position are the cursor commands (JUMP, 
UP, DOWN, RIGHT, LEFT) and the tab commands (TAB, ВАСКТАВ). In addition, even 
though there is no “HOME” command corresponding to the HOME key, the JUMP 
command can be used to simulate the action of the HOME key. (See discussion of the 
JUMP command.) 


NOTE 


If a cursor movement command, tab command, or scrolling command is 
typed on the keyboard and text from the keyboard is directed into the 
monitor, execution of the command inserts a line just below the line on 
which the command is typed. 
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JUMP Command (Workspace only) 


Syntax 
IJUMp [<row>[<column>]]<CR> 


where <row> is a positive integer, and <column> is a positive integer not greater than 
80. If only one parameter is specified, it is assumed to be the <row> parameter. If neither 
parameter is specified, both <row> and <column> default to one. 


Action 


This command positions the workspace cursor in the row and column of the workspace 
designated by <row> and <column>, respectively. 


Picture the workspace scroll as a long table with an indeterminate number of rows, each 
row having 80 columns (Figure 6-1). The topmost row in the workspace, (whether it 
contains text or is blank) is labeled row 1, the next row is row 2, and so forth. In each row, 
columns are labeled column 1, column 2,..., 80. This establishes an absolute coordinate 
system in the workspace scroll. Portions of this scroll may be visible in the workspace 
window. 


The JUMP command moves the workspace cursor to the specified row and column of the 
workspace, expressed in absolute workspace coordinates. The destination of the cursor 
does not depend on its current location. (This is in contrast to the other cursor movement 
commands, whose parameters specify positions relative to the current cursor position.) 


If the <row> parameter specifies a row of the workspace below the bottom of the 
workspace window, the workspace rolls up and stops with the line containing the cursor 
at the bottom of the window. If «row exceeds the current number of lines in the 
workspace, blank lines are created at the bottom of the workspace and the <row>-th row 
is displayed as the last row in the workspace window. 


If the <row> parameter specifies a row of the workspace above the top of the workspace 


window, the workspace rolls down, stopping with the row containing the cursor at the top 
of the window. 
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WORKSPACE 
(N,80) WINDOW 
Row N, Column 1 Row N, Column 80 


2402-9 


Figure 6-1. The Workspace Window and the Workspace Scroll. 


NOTE 


This command applies only, and always, to the workspace cursor. It is not 
necessary for the workspace to receive text from the computer or the 
keyboard for this command to move the workspace cursor. When the 
workspace cursor next appears, it appears at the location specified in the 
JUMP command (assuming no other instructions which affect the 
workspace cursor location have been given to the terminal meanwhile). 
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Examples 
1. The command 
ШОМ 3,10<CR> 
moves the workspace cursor to row 3, column 10. 
2. Either of the commands 


IJUM 3<CR> 
МОМ 3,1<CR> 


moves the workspace cursor to row 3, column 1. 
3. Any one of the commands 
IJUM «CR» 


МОМ 1 «CR» 
МОМ 1,1 «CR» 


moves the workspace cursor to row 1, column 1. Each of these commands is 
equivalent to pressing the HOME key when the workspace cursor is visible and 
the terminal is not in form fillout mode. 
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UP Command 


Syntax 
IUP [<count>]<CR> 


where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 


This command is equivalent to pressing the up cursor key (pad key 8, marked 1) 
<count> times. 


This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 

text from the keyboard. If the command is sent from the computer, it moves the cursor in 

that scroll which receives text from the computer. 


Suppose text from the computer is printed in the workspace and the command 
ШР «count» «CR» 


is sent from the computer. This command moves the workspace cursor up «count» lines 
from its current position, leaving the column location unchanged. 


If «count» is large enough to move the cursor to a line not visible in the workspace 
window, the workspace rolls down so that the line which the cursor moves to is the top 
line in the window. However, the cursor will not move past the first line of the workspace, 
regardless of how large «count» is. 


If text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 
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Examples 


Suppose text from the computer is printed in the 
workspace, with the cursor in line 23, column 5: 


1. The command 
„ОР 3<CR> 


positions the cursor in line 20, column 5. 


2. The subsequent command 
IUP 7 «CR» 


causes the workspace to roll down and 
positions the cursor in line 13, column 5. 


Line 20 
Line 21 
Line 22 
Цпе,23 


Line 25 COLUMN 5 


Li 2! 
[e NN AFTER !UP 3< CR» 


CURSOR IN LINE 20, 
COLUMN 5 


Line” 4 AFTER !UP 7<CR> 
< CURSOR IN LINE 13, 
$ COLUMN 5 


Line 20 
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3. The subsequent command 


AFTER !UP 13<CR> 
CURSOR IN LINE 1, 
COLUMN 5 


IUP 13<CR> 
rolls the workspace down, leaving the cursor || 7 7 7 777 
in column 5 of line 1. Since the workspace 
will not scroll past the first line, the com- 
mands 


IUP 14<CR> 
IUP 15<CR> 


each have the same effect. 
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DOWN Command 
Syntax 
IDOWn [<count>]<CR> 


where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 


This command is equivalent to pressing the down cursor key (pad key 2, marked |) 
<count> times. 


This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 
text from the keyboard. If the command is sent from the computer, it moves the cursor in 
that scroll which receives text from the computer. 


Suppose text from the computer is printed in the workspace and the command 
ОМ «count» «CR» 


is sent from the computer. This command moves the workspace cursor down «count» 
lines from its current position, leaving the column location unchanged. 


If «count» is large enough to move the cursor to a line not visible in the workspace 
window, the workspace rolls up until the line which the cursor moves to is at the bottom of 
the window. If «count» is large enough to move the cursor past the last line in the 
workspace, enough blank lines are created at the bottom of the workspace to 
accommodate this command. 


If text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 


Pressing the LINE FEED key «count» times has the same effect on the cursor. Pressing 
this key also generates the ASCII Line Feed character, while pressing the down cursor 
key does not. 
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Examples 

Suppose a workspace window of ten lines is 
defined, and the workspace contains 20 lines of text 
(some of which may be blank). Suppose also that 


line 1 is the top line in the workspace window and 
the cursor is in line 1, column 6. 


1. The command 
IDOW 8<CR> 


moves the cursor down eight lines to line 9, 
column 6. No roll up occurs. 


2. The subsequent command 
IDOW 5<CR> 


moves the cursor to line 14, column 6; the 
workspace rolls up four lines. 


3. The subsequent command 
РОМ 10<CR> 


adds four blank lines at the bottom of the 
workspace and rolls the workspace up 10 
lines. The cursor stops in the last blank line 
created, at the bottom of the workspace 
window. 
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j-— — — ——... CURSOR IN LINE 1, 
COLUMN 6 


Line 19 
Line 20 


AFTER !DOW 8 < CR» 
CURSOR IN LINE 9, 
COLUMN 6 


Line gue 


Line 10 


Line 19 
Line 20 


AFTER !DOW 5- CR» 
一 CURSOR IN LINE 14 
13 , 
mis COLUMN 6 


Line 19 
Line 20 


Line 15 


Line 20 

Line 21 (blank) 

Line 22 (blank) AFTER !DOW 10< CR» 
Line 23 (blank) << CURSOR IN LINE 24, 
Line 24 (blank) 一 COLUMN 6 
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RIGHT Command 


Syntax 
IRIGht [<count>]<CR> 


where «count» is a positive integer. If «count» is not specified, it defaults to one. 


Action 


This command is equivalent to pressing the right cursor key (pad key 6, marked —) 
« count» times. 


This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 
text from the keyboard. If the command is sent from the computer, it moves the cursor in 
that scroll which receives text from the computer. 


Suppose text from the computer is printed in the workspace and the command 
IRIG «count» «CR» 


is sent from the computer. This command moves the workspace cursor « count 
columns to the right. 


If «count» is large enough to move the cursor beyond column 80, the cursor wraps 
around to the left margin of the next line and continues moving right a total of «count» 
columns. If this action requires the cursor to move to a line which is not visible in the 
workspace window, the workspace rolls up so that the line in which the cursor stops is 
the bottom line in the window. If this command requires the cursor to move beyond the 
last line of the workspace, enough blank lines are created at the bottom of the scroll to 
accommodate this command. 


If text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 
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Suppose there is a workspace window о ten lines, 
with ten lines of text in this window. The left margin 
is set at column 1 and the cursor is in column 1 of 

line 8. 


1. The command 
IRIG 7<CR> 


moves the cursor right seven columns to 
column 8 of line 8. 


2. The subsequent command 
IRIG 153« CR» 


moves the cursor through the remaining 73 
columns of line 8 to column 1 of line 9, then 
through the 80 columns of line 9 to column 1 
of line 10. No roll up occurs. 


3. The subsequent command 
IRIG 167 «CR» 


moves the cursor through the 80 columns of 
line 10, creates a blank line 11 and moves 
the cursor through the 80 columns of line 
11, creates a blank line 12 and moves the 
cursor through seven columns to column 8 
of line 12. The workspace rolls up to display 
line 12 as the last line in the workspace 
window. 
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_____ CURSOR IN LINE 8, 
COLUMN 1 


|. AFTER IRIG 7<CR> 
CURSOR ІМ LINE 8, 
COLUMN 8 


__АЕТЕР !RIG 153<CR> 
CURSOR IN LINE 10, 
LUMN 1 


Line 3 
Line 4 


Line 9 
Line 10 AFTER !RIG 167 « CR» 
Line 11 (blank) / CURSOR IN LINE 12, 


Line 12 (blank) 一 COLUMN 8 
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LEFT Command 
Syntax 
ILEFt [<count>]<CR> 


where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 


This command is equivalent to pressing the left cursor key (pad key 4, marked —) 
<count> times. 


This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 

text from the keyboard. If the command is sent from the computer, it moves the cursor in 

that scroll which receives text from the computer. 


Suppose text from the computer is printed in the workspace and the command 
ПЕЕ «count» «CR» 


is sent from the computer. This command moves the workspace cursor «count» 
columns to the left. 


If «count» is large enough to move the cursor to the left of the left margin, the cursor 
wraps around to column 80 of the preceding line and continues moving left a total of 

« count» columns. If this action requires the cursor to move to a line which is not visible 
in the workspace window, the workspace rolls down so that the cursor stops in the top 
line of the window. However, the cursor will not move above the first line in the workspace. 
Thus this command does not insert blank lines at the top of the workspace. 


If text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 
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Suppose a workspace is defined and the cursor is 
visible in column 10 of line 6. 


. The command 


ПЕЕ 9<CR> 


moves the cursor to column | of line 6. 


. The subsequent command 


ЦЕР 150<CR> 


moves the cursor through the 80 columns in 


line 5, rolls down the workspace to display 
line 4, and moves the cursor through the 
rightmost 70 columns in line 4. The cursor 
stops in column 11 of line 4. 


. The subsequent command 


ILEF 300<CR> 


moves the cursor through the leftmost ten 
columns in line 4, then through the 80 
columns in each of lines 3, 2, and 1, rolling 


the workspace down to display these lines. 


The cursor stops at column 1 of line 1. 
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2 CURSOR IN LINE 6, 
COLUMN 10 


~~~ AFTER ЦЕР 9 « CR» 
CURSOR IN LINE 6, 
COLUMN 1 


— AFTER !LEF 150 « CR» 
CURSOR IN LINE 4, 
COLUMN 11 


一 一 AFTER ПЕЕ 300 « CR» 
CURSOR IN LINE 1, 
COLUMN 1 
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THE TAB COMMANDS 
TAB Command 
Syntax 

ІТАВ [<count>]<CR> 


where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 
This command is equivalent to pressing the TAB key <count> times. 


This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 
text from the keyboard. If the command is sent from the computer, it moves the cursor in 
that scroll which receives text from the computer. 


Suppose text from the computer is printed in the workspace and the command 
ТАВ «count» «CR» 


is sent from the computer. This command moves the workspace cursor «count» tab 
stops to the right. If there are no tab stops defined to the right of the current cursor 
position, the next tab moves the cursor to the beginning of the next line. Thus if «count» 
is large enough to move the cursor past the last tab stop in a line, the cursor jumps to 
column 1 of the next line and continues tabbing a total of «count» stops. Each skip to 
the next line, as well as each skip to the next tab stop in a line, accounts for one of the 
«count» tabs. If «count» is large enough to move the cursor below the bottom of the 
workspace window, roll up occurs. 


If «count» is large enough to move the cursor past the last line in the workspace, 
enough blank lines are created at the bottom of the workspace to accommodate the 
command. 


If the text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 
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Suppose there is a workspace window of ten lines, 
with tab stops in columns 10, 20, and 30, and the РОБЕР US 
cursor is т line 9, column 1. пез — 一 ” COLUMN 1 


TAB STOPS IN COLUMNS 
10, 20, AND 30 


1. The command 


ТАВ 4<CR> 


_ AFTER ТАВ 4< CR> 
.— CURSOR IN LINE 10, 
5 COLUMN 1 


moves the cursor {о the three stops т line 9 
and then to column 1 of line 10. 


2. The subsequent command 


ТАВ 17 «CR» 
Line 5 и 
moves the cursor to column 10 (the first кее, 
stop) in line 14. Тһе first 16 tabs move the Le i3 (blank) GURSORINLINE 14, 


Line 14 (blank) 一 COLUMN 10 


cursor through lines 10, 11, 12, апа 13, to | | p-------------- 
column 1 of line 14; the final tab moves the 
cursor from column 1 of line 14 to the first 
tab stop in line 14. 


NOTE 


The TAB command, like the TAB key, performs a different action when the 
4027 is in form fillout mode. See the Forms and Form Fillout section for 
details. 
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BACKTAB Command 
Syntax 
IBACktab [<count>]<CR> 


where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 


This command is equivalent to pressing the BACKTAB key (SHIFT-BACKSPACE) 
<count> times. 


This command can be used to move either the workspace cursor or the monitor cursor. If 
the command is typed on the keyboard, it moves the cursor in that scroll which receives 
text from the keyboard. If the command is sent from the computer, it moves the cursor in 
that scroll which receives text from the computer. 


Suppose text from the computer is printed in the workspace and the command 
ВАС «count» «CR» 


is sent from the computer. This command moves the workspace cursor «count» tab 
stops to the left. Each backtab moves the cursor one tab stop to the left, or to the left 
margin if there are no tab stops to the left of the cursor position. The cursor does not 
move to a preceding line of text, regardless of how large «count» is, but "sticks" at the 
left margin of the current line. 


If text from the computer is printed in the monitor and this command is sent from the 
computer, it has the same effect on the monitor cursor. 
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Suppose tab stops аге set at columns 10, 20, 30, 


and 40 and the cursor is in column 35. 


1. The command 


IBAC<CR> 


moves the cursor left one stop to column 30 


of the current line. 


2. Any of the subsequent commands 


ВАС 3<CR> 
ВАС 4<CR> 


moves the cursor to column 1 of the current 


line. 
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CURSOR IN LINE N, 
COLUMN 35 


С ТАВ STOPS IN COLUMNS | 
10,20,30, AND 4 


AFTER !BAC <CR> 
CURSOR IN LINEN, 
COLUMN 30 


hine N 

= AFTER ВАС 3<CR>, 

IBAC 4<CR>, ETC. 

CURSOR IN LINE N, 
COLUMN 1 


The BACKTAB command, like the BACKTAB key, performs а different 
action when the 4027 is in form fillout mode. See the Forms and Form 


Fillout section for details. 


4027 PROGRAMMER'S 


6-17 


CONTROLLING THE DISPLAY 
RUP COMMAND 


THE SCROLLING COMMANDS 
RUP (Roll Up) Command 
Syntax 

IRUP [<count>]<CR> 


where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 


This command is equivalent to pressing the up scrolling key (pad key 7, marked A) 
<count> times. 


This command rolls up the current scroll (workspace or monitor) <count> lines, or until 
the last line of the scroll is visible at the bottom of the window. This command does not 
create blank lines at the end of the scroll. If «count» is larger than the number of lines 
remaining in the scroll, the scroll rolls up until the last line of the scroll is visible in the 
window, then stops. 


When the scroll rolls up, the cursor moves with it, remaining in the same line of text, at the 
same column position, as long as that line of text remains visible. If that line of text passes 
out of the window, the cursor “sticks” at the top of the window, with the column position 
unchanged. 


Examples 
Suppose a workspace window of ten lines is 


defined, the workspace scroll contains 30 lines, and 
the cursor is in line 9, column 5. 


CURSOR IN LINE 9, 
COLUMN 5 
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IRUP 8<CR> 


leaves line 9 at ће top of the workspace, 
with the cursor in line 9, column 5. 


2. The subsequent command 
IRUP 10<CR> 


leaves line 19 at the top of the workspace 


3. Any of the subsequent commands 


IRUP 2<CR> 
IRUP 3<CR> 


leaves line 30 at the bottom of the work- 
space window, with the cursor in line 21, 
column 5. 
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Цпе,9 


a AFTER RUP 8<СН> 
Біле CURSOR IN LINE 9, COLUMN 5 


AT TOP OF WORKSPACE WINDOW 


Line 17 
Line 18 


Line 29 
Line 30 


— — —. AFTER !RUP 10<CR> 
CURSOR IN LINE 19, COLUMN 5 
AT TOP OF WORKSPACE WINDOW 


Line 27 
Line 28 


( — AFTER ВИР 2< CR», 

!RUP 3< CR», ETC. 
CURSOR IN LINE 21, COLUMN 5 
AT TOP OF WORKSPACE WINDOW 
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RDOWN (ROLL DOWN) Command 
Syntax 
IRDOwn [<count>]<CR> 


where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 


This command rolls down the current scroll (workspace or monitor) <count> lines, or 
until the first line of the scroll is at the top of the window. The RDOWN command cannot 
be used to insert blank lines at the top of the workspace. 


Giving this command is equivalent to pressing the down scrolling key (pad key 1, marked 
У) <count> times. 


When the current scroll rolls down, the cursor moves with it, remaining at the same row 
and column position as long as that position is visible in the window. If that position 
passes out of the window, the cursor "sticks" at the bottom line of the window, with the 
column position remaining unchanged. 


Examples 


Suppose a workspace window of ten lines is 
defined, with a workspace scroll of 30 lines and the 
cursor positioned in line 21, column 5. 
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1. Тре соттапа 
IRDO 9<CR> 


rolls the workspace down 9 lines, leaving the 
cursor still positioned in line 21, column 5. 


2. The subsequent command 
IRDO 6<CR> 


rolls the workspace down an additional six 
lines, leaving the cursor in line 15, column 5, 
at the bottom of the window. 


3. Any of the subsequent commands 


IRDO 5<CR> 
ро 6<CR> 
IRDO 7 «CR» 


rolls the workspace down five lines, with the 
cursor in line 10, column 5, at the bottom of 
the window. 
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Line 12 
Line 13 


~ AFTER 1800 9 «CR» 
Line 20 | CURSOR IN LINE 21, COLUMN 5 
Line,21 | AT BOTTOM OF WORKSPACE WINDOW 


Line 29 
Line 30 


__________ AFTER !RDO 6 СА > 
Line 14 CURSOR IN LINE 15, COLUMN 5 
Line15 / ATBOTTOM OF WORKSPACE WINDOW 


Line 29 
Line 30 


AFTER !RDO 5< CR», 

| || !RDO 6<CR>, ЕТС. 
Line 9 / CURSOR IN LINE 10, COLUMN 5 
Line,10 / AT BOTTOM OF WORKSPACE WINDOW 
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ADDITIONAL COMMANDS 
ERASE Command 
Syntax 


IERAse | Workspace | Monitor | < CR» 


Action 


This command erases the specified scroll. The entire scroll, not just the portion visible in 
the window, is erased. If text is currently directed into that scroll, the cursor quickly 
reappears in the home position (line 1, column 1, in the upper left corner) of the window. If 
text is not currently directed into that scroll, the next time that cursor appears, it appears 
in the home position. This command does not affect the size of the workspace апа 
monitor windows. 


If no parameter is specified, the source of the command determines which scroll is 
erased. If the commmand is sent from the computer and no parameter is specified, the 
scroll which receives text from the computer is erased. If the command is typed on the 
keyboard and no parameter is specified, the scroll which receives text from the keyboard 
is erased. 


Examples 
1. ЕВА W<CR> Erases the workspace scroll and returns the workspace 
cursor to the home position. This destroys any graphic area 
which has been defined. 
2. ЕВА M<CR> Erases the monitor scroll and returns the monitor cursor to 
the home position. 
З. |ERA<CR> If sent from the computer, this command erases whichever 


scroll receives text from the computer. 


If typed on the keyboard, this command erases whichever 
scroll receives text from the keyboard. 


NOTE 


The ERASE command can also be used to erase the contents of a 
graphics region in the workspace by entering the command !ERA 


G< CR». See the Graphics section for details. 
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BELL Command 
The 4027 contains a bell. This bell sounds automatically when certain conditions occur; 
for example, the bell rings if the operator types beyond the right margin, or if an attempt is 
made to enter a character in a protected field when the terminal is in form fillout mode. 
The programmer may wish to sound the 4027 bell at various times during an applications 
program — perhaps to remind the operator to enter data, or to press a function key. The 
BELL command is used for this purpose. 
Syntax 

IBELI C CR» 


or 


IBEL<CR> 


Action 


This command sounds the 4027 bell. The bell also sounds when the ASCII BEL character, 
CTRL-G, is sent to the terminal. 
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4027 COLOR COMMANDS 


The 4027 has a palette of 64 distinct colors. Of these 64, eight may be selected at any 
one time to create graphics, to develop unique symbols and patterns, and to assign colors 
(visual attributes) to the character fonts. These eight colors are assigned color numbers 
CO, C1,..., C7, respectively. This section explores the commands used to select and 
invoke the various colors and how patterns may be created. 


Appendix A, the Tektronix Color Standard, should be reviewed before using the 
commands discussed in this section. The Tektronix 4027 Color Standard is a model used 
to explain the relationship between hue, lightness, and saturation and how they are used 
to achieve a particular color. 


THE COLOR COMMANDS 


There are five commands which control the selection and assignment of color on the 
display. The COLOR command is used to assign one of the eight color numbers (СО-С7) 
or one of 120 possible patterns (PO-P119) to be used in any subsequent graphic 
displays. The MAP, RMAP, and MIX commands are used to determine which of the 64 
possible colors will be assigned to the eight color numbers. The PATTERN command is 
used to define any of 120 patterns. Each of these commands will be discussed in turn. 
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COLOR Command 
The COLOR command is used to designate the color of subsequent graphics. 
Syntax 


ICOLor <vector color no.>/<vector pattern no.>[<boundary color 
no.>/<boundary pattern no.>]<CR> 


where 
<vector color number> is one of CO, C1,..., C7. 
<vector pattern no.> is one of PO, P1,...,P119. 


<boundary color no.> is one of CO, C1,..., C7. 


« boundary pattern no.» is one of РО, P1,...,P119. 


Action 


The first parameter (« vector color no.» / « vector pattern no.>) specifies the color or 
pattern which will be used to draw subsequent vectors or fill subsequent polygons. If a 
boundary color or pattern is required, then the second parameter ( « boundary color 
по. > /« boundary pattern по. >) is given. The boundary parameter is optional. If no color 
command is given, the default color for subsequent vectors and polygons is CO (default 
white). Valid colors for both vectors and boundaries аге CO-C7 and PO-P1 19. 


Examples 
ICOLor C1 «CR» 

All vectors and polygons will be color C1 (default color red). 
ICOL C1 C2<CR> 


АН vectors and polygons will be color C1 (default color red) and the polygons will have а 
boundary color C2 (default color green). 


СОГ P1« CR» 
АП vectors and polygons will be pattern P1. 


СОГ P1 C4<CR> 


АП vectors and polygons will be drawn in pattern P1. The polygons will have a boundary 
of color C4. Pattern P1 must be defined by the PATTERN command prior to its use іп а 
COLOR command. Refer to the PATTERN command described later in this section. 
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MAP Command 


The 4027 provides a selection of 64 possible colors of which eight (CO-C7) may be 
designated at any one time. If colors other than the eight default colors are desired, the 
MAP command may be used to set the hue, lightness, and saturation to redefine any of 
the eight color numbers. If a MAP command is not given, default colors for CO-C7 аге 
white, red, green, blue, yellow, cyan, magenta, and black, respectively. 


Syntax 
МАР «Cn» «hue angle» <lightness> «saturation» «CR» 
where 


«Cn» is one of eight color numbers (CO-C7). 
«hue angle» is an integer from O to 360. 


<lightness> and «saturation are integers from О to 100. 


NOTE 


Refer to Appendix A for further information on the Tektronix 4027 Color 
Standard. 


Action 
The «Cn» indicates which of the eight color numbers (CO-C7) is being MAPped. 


«Hue angle» is a gradation of color measured around a circle as an angle from O to 360 
degrees. Referring to the color cone in Appendix A, observe that a «hue angle» of O 
degrees always specifies one of several shades of blue, 60 degrees magenta, 120 
degrees red, 180 degrees yellow, 240 degrees green, апа:300 degrees cyan (360 
degrees — 0 degrees). If a «hue angle» is given between two of these angles, an 
intermediate color is produced. For example, specifying а «hue angle» between 0 and 
60 gives a color between blue and magenta. 


The <lightness> and «saturation» parameters determine which shade of the given hue 
will be produced by a given «hue angle». Again referring to the color cone in Appendix 
A, notice that <lightness> is expressed as a value between 0 percent (black) at the 
bottom of the cone and 100 percent (white) at the top. This means that any of the colors 
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selected by the <hue angle> parameter will be shaded according to the value given by 
the <lightness> parameter. In addition, if the value of <lightness> is О percent, the 
color produced will be black regardless of the <hue angle> or <saturation>. 
Conversely, a <lightness> value of 100 percent always produces white. 


The third parameter of the MAP command, <saturation>, sets the amount of gray to be 
contained at a given «hue angle» апа < Па пезз>. As the saturation approaches 100 
percent, less gray is added and a purer hue is produced. 


NOTE 


Small changes in any of the HLS parameters may not produce a change in 
the MAPped color. For example, if the « hue angle» of 120 degrees, which 
produces red, is changed to 125 degrees, the red hue is still produced. The 
same is true for small changes in the « lightness» and « saturation 
parameters. A total of 64 colors can be displayed. Each of these is 
invariant over a finite range in each parameter. 


The SYSTAT message displays the HLS (hue, lightness, saturation) parameters assigned 
to each of the colors CO-C7, along with a color sample. All colors return to their default 
parameters when the 4027 is powered off or RESET. 


The default colors for CO-C7 and their respective default parameters are as follows: 


CO (white) — 0,100,100 

C1 (red) — 120,50,100 

C2 (green) — 240,50,100 
C3 (blue) — 0,50,100 

C4 (yellow) — 180,50,100 
C5 (cyan) — 300,50,100 
C6 (magenta) — 60,50,100 
C7 (black) — 0,0,100 


Examples 


МАР C1 0,50,100< CR» Sets <color number» C1 (default red) to a «hue 
angle of O degrees (blue), а <lightness> of 50%, 
and «saturation > of 100%. Color number C1 is 
then blue. 


IMAP C4 240,50,50< CR» Sets «color number» C4 (default yellow) to a 
« hue angle» of 240 degrees, <lightness> of 50%, 
and «saturation > of 50%. Color number C4 is then 
green. 
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RMAP (Relative MAP) Command 
The RMAP command changes a color’s HLS parameters by amounts specified relative to 
the current HLS parameters. 
Syntax 
IRMAp «Cn» «hue angle» <lightness> <saturation><CR> 
where 


« Cn» is one of the color numbers СО, С1,..., C7. 
« hue angle» is a positive or negative integer from O to 360. 


«lightness > and «saturation are positive or negative integers from O to 100. 


Action 


«Cn» is the color number to be redefined. The color may be redefined by changing the 
с hue angle» a number of degrees or by changing the <lightness> or «saturation a 
given percentage. Any or all of the parameters may be changed in an RMAP command. If 
zero (0) is entered for any of the parameters, then no change is made to that parameter. 


NOTE 


Small changes in the HLS parameters may not produce a visible change in 
the displayed color. Refer to Appendix A for further information. 


When a SYSTAT command is given, it will display the RMAPped color and the current 
HLS parameters for that color. When the 4027 is powered off or RESET, all eight colors 
return to their default values. 
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The default colors for CO-C7 and their respective default parameters are as follows: 


CO (white) — 0,100,100 
C1 (red) — 120,50,100 

C2 (green) — 240,50,100 
C3 (blue) — 0,50,100 

C4 (yellow) — 180,50,100 
C5 (cyan) — 300,50,100 
C6 (magenta) — 60,50,100 
C7 (black) — 0,0,100 


Examples 
IRMAP C1 0,10,0<CR> 


C1 has default HLS parameters 120, 50, 100. By entering the command above, the 
<lightness> is changed 10 percent. The new HLS parameters for C1 are then 
120,60,100. Notice that since 0 was entered for the <hue angle> and <saturation> 
parameters, <hue angle> and <saturation> are not changed. The revised parameters 
and a color sample will appear when a new SYSTAT message is displayed. 


IRMAP C2 30,—25,—50« CR» 
C2 has default HLS parameters of 240,50,100. This command will change the «hue 


angle» from 240 to 270 degrees, the <lightness> from 50 to 25 percent, and the 
« saturation > from 100 to 50 percent. 
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MIX Command 


The MIX command provides an alternative to the MAP and RMAP methods of defining the 
color assigned to a given color number. The MIX command combines proportionate 
amounts of red, green, and blue to create one of the 64 possible colors. 


Syntax 


IMIX <Cn> <red> <green> <blue><CR> 
where 


«Cn» is one of the eight color numbers CO-C7. 
<red>, <green>, and <blue> are positive integers from 0 to 100. 


Action 


This command redefines the color Cn by mixing the basic colors of red, green, and blue. 
The <red>, <green>, and <blue> parameters specify the amount of the corresponding 
colors to be MIXed, in percentages of full intensity. Small changes in the percentages of 
«red», «green», or «blue» may not cause the displayed color to change. 


If a SYSTAT message is displayed, it will show the newly MIXed color but the HLS 
parameters will be shown as 0,0,0. 


Examples 
МК C2 25,0,100- СВ > 


Color C2 will have a «red» component which is 25 percent of its full intensity, no 
«green» component, and a «blue» component which is 100 percent of its full intensity. 


МК C2 0,0,0 x CR» 
Color C2 is a mixture of red — 0%, green — 0%, blue — 0%. With this mixture, C2 is black. 
IMIX C2 100,100,100 < CR» 


Color C2 is a mixture of red — 100%, green — 100%, blue — 100%. With this mixture, C2 
is white. 


МІХ СЗ 50,50,0< CR» 


Color СЗ will have: «red» and «green» components which are both 50 percent of their 
full intensity, and zero «blue» component. 
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PATTERN Command 


The PATTERN command is used to define a colored pattern for use in vector drawing, 
polygon filling, and so forth. The 4027 can have 120 user-defined patterns in its memory 
at any one time. 


Syntax 


IPATtern «Pn» [<background СО >] «foreground COL» [<value 1>]... 
[<value 14>] [<foreground color>[<value 1>]...[<value 14>]]...<CR> 


where 


«Pn» is one of PO, Р1,..., P119. 


<background COL >, «foreground COL >, and all occurrences of «foreground 
color > are chosen from CO, С1,..., C7. 


All «value i> parameters are integers from О to 255. If less than 14 «value i> 
parameters are specified, the omitted ones default to zero. 


Action 


The pattern Pn is defined by setting the color of each dot in a color cell. If two colors are 
given, the first is the «background color», and the remainder of the command consists of 
groups that specify a «foreground color» and the dots that are to be made that color. 
Once a «foreground color» is set, all the dots which are designated by the following 

« value number will be made that color. Sets of dots within each row may be set to 
different colors by giving additional « foreground colors» and specifying the dots to be 
made that color by giving additional «value numbers». In this manner, it is possible to 
have each of the eight dots in each row be an individual color. 


The dots which are turned оп to create the pattern are set by giving a «value number > 
which is an integer between O and 255. «value numbers» are decimal equivalents of 
binary numbers and are assigned for each of the 14 rows of the color cell. If a «value 
number » О or no «value» is given for any row, the «background color» is displayed. 


Examples 
IPATtern PO C2 СЗ 0,0,0,0,60,60,60,60,60,60,0,0,0,0 « CR» 


Pattern PO will have a «background color» C2, which will be the color for all of the rows 
which have a «value» of О. Rows 5 through 10, which are given a «value» of 60, will 
have some of their dots turned on in the «foreground color (СЗ) as shown. Тһе 

rest of their dots will be color C2. 


7-8 @ 4027 PROGRAMMER'S 


COLOR COMMANDS 
PATTERN COMMAND 


A USER DEFINED PATTERN 


Eight-Bit Pattern Within 
Integer Binary Equivalent One Color Cell 


0 
о 

0 
о 

0 
0 
о 
0 
0] 


о|о|о|-|-|-|-|-|-[о[о| 


222 


о|о|о|о|-|-|-|-|-|-|о|о| 


Foreground Background 
Color Color 


IPAT P1 C1 C3 7,7,7,7,7,7,7,7,7,7,7,7,7,7 C2 
24,24,24,24,24,24,24,24,24,24,24,24,24,24 « CR» 


Pattern P1 will have a «background color» C1 (default red) which will fill the dots not 
designated by the «foreground COL > parameter. The rightmost three columns of the 
color cell are displayed in color C3 (default blue). Columns four and five (counting from 
the right) are displayed in color C2 (default green). The remaining columns have not been 
designated by this command and will therefore appear in the «background color C1. 


Notice that when a new «foreground color» is given, a «value number? is given for 
each row, starting at row one (the topmost row). The illustration below shows the integers 
used, the eight-bit binary equivalent, and the pattern. 


A USER DEFINED PATTERN 


Color 1 Color 2 Color 3 
(< Background» ) 
No Integers Eight-Bit 
Assigned Integer Integer Binary Equivalent Pattern 


24 
24 
24 
24 
24 
24 
24 
24 
24 


24 
24 


24 
24 
24 


NNNNNNNNNNNNNN 


BINARY BINARY 
00011000 00000111 
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Тһе 4027 has extensive color graphics capability. | can draw several styles of vectors 
(line segments), intermix graphics with text and forms, and store special purpose 
character fonts defined by the user. The 4027 can also draw circles, pies (filled circles), 
and polygons. All these features include color capability. 


THE GRAPHIC COMMANDS 


This section contains a discussion of each of these commands, in the order in which they 


рер жексен Жеке» 二 ] 二] нео 二 二 二 二 有 


Тһеге аге Seventeen commands designed for creating color graphic displays on the 4027. 


pu 


^^ аге listed: 
П е Graphic е Сігсіе 
е Enable е Ink 
е Disable е String 
| € Vector e Erase G 
е RVector e Shrink 
е Line e Symbol 
1 е Роу ө Ғопі 
е RPoly е DFont 
| е Рје 
Ф 
4027 PROGRAMMER'S @ 


GRAPHICS 
GRAPHIC COMMAND 


8-2 


GRAPHIC Command 
Graphics are displayed in the 4027 workspace. Before this can be done, the workspace 


must be prepared to display graphs by defining a graphic region. The GRAPHIC command 
is used for this purpose. 


Syntax 

IGRAphic «beg row» «end row>[<beg col>[<end col>]]<CR> 
where all parameters are positive integers designating rows and columns in absolute 
workspace coordinates. Thus «beg row must be less than «end row», « beg col» 
must be less than «end col», and «end col» must be less than or equal to 80. Also, 


« end row» must not exceed «beg row» by more than 53 rows. The default values of 
« beg col» and « end col» are 1 and 80, respectively. 


Action 

This command defines a graphic region in the 4027 workspace and erases all information 
currently stored in this region. The graphic region thus defined consists of rows « beg 
row» through «end row», and columns « beg col» through « end col» in each of these 
rows. 

Examples 


IGRAphic 1,33« CR» 


Creates a graphic region in the workspace containing columns 1 through 80 of rows 1 
through 33. 


IGRA 1,33,30< CR» 


Creates a graphic region in the workspace containing columns 30 through 80 of rows 1 
through 33. 


The structure of a graphic region is best illustrated by an example. The command 
IGRA 10,19,20,49 « CR» 


creates a graphic region which occupies rows 10 through 19, columns 20 through 49 in 
each of these rows. 
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As illustrated іп Figure 8-1, this graphic region is 10 cells (character cells) high апа 30 
cells wide. Each cell consists of a dot matrix 8 dots wide by 14 dots high. Each dot can be 
turned on (lighted). Various commands discussed in this section create graphic displays 
or display user-defined symbols by turning on patterns of these dots. 


ооооооовооооо 

оооооооФоооооо 
ооооооооФООООО 
ооооооооФООООО 


О 
ООО 
ооо 
ооо 
ooe 
вес 
ООО 
ООО 
ООО 
ООО 
ООО 


EACH CELL IS 
A 14x8 MATRIX 


(2401) 2657-10 


Figure 8-1. A Graphic Region. 


The columns of dots are numbered from left to right across the graphic region, starting 
with O for the leftmost column, and from bottom to top, starting with O for the bottom row. 
In Figure 8-1, the 240 columns of dots (30 cells, each cell 8 dots wide) are numbered 
from 0 to 239; the 140 rows of dots (10 cells, each cell 14 dots high) are numbered from 
O to 139. This establishes a coordinate system in the graphic region. For each dot in this 
region there is a pair of numbers: its X- and Y-coordinates. The X-coordinate gives the 
dot's horizontal position; the Y-coordinate gives the dot's vertical position. These 
coordinates are used in the VECTOR, POLYGON, PIE, and CIRCLE commands. 


This coordinate system is also used in the RVECTOR and RPOLYGON commands. In 
these commands, however, each coordinate pair is relative to the last coordinate pair 
given in the command. 


It is possible to define more than one graphic region in the workspace. If this is done, new 
graphic commands affect only the graphic region most recently defined. Different graphic 
regions should not overlap. 
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ENABLE Command 
The ENABLE command places the 4027 in the Graphic Input (GIN) mode. This mode is 
used to provide graphic beam position and color information to the host computer. 
Syntax 

IENAble [<count>]<CR> 
where <count> is a positive integer specifying the number of points to be sent to the 
host computer. If <count> is not specified, it defaults to infinity. 

NOTE 


GIN mode may also be initiated by pressing the crosshair key. 


Action 


The ENABLE command causes the terminal to enter GIN mode. When GIN is first 
ENABLEd, the crosshair is displayed at the graphic beam position. The crosshair can then 
be manipulated with the cursor control and home keys. 


When a key other than the crosshair control key is pressed, a report is sent to the host. 
The report is in the form: 


<ста. chr.> DAT 03, <key>, <x pos>, <y pos> <color>; 

where 
с ста. chr.> is the current command character. DAT 03 indicates the crosshair 
device. 


«key» is the ASCII decimal equivalent of the key value that generated this report. 


«Xx pos» is a three-digit number indicating the location of the crosshair with respect 
to the horizontal axis. 


«y pos» is a three-digit number indicating the location of the crosshair with respect 
to the vertical axis. 


« color» is a three-digit number indicating the color of the point at that location. 
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The 4027 remains in GIN mode until one of the following occurs: 


е the crosshair key is pressed. 
е a DISABLE command is sent from the host or typed on the keyboard. 


ө the specified <count> number of points and the carriage return have been sent. 
An end-of-line sequence is not sent between each point when multiple points are 
sent. 


Certain characteristics of the graphic beam during GIN mode should be noted. When 
ENABLE is given, the crosshair is displayed at the graphic beam position. Н the crosshair 
is moved, the graphic beam is moved to the crosshair position when a key is pressed. 
Also, if INKing is on, a line is drawn from the previous graphic beam position to the 
present crosshair position when a key is pressed. The key normally used to set the 
graphic beam at the position of the crosshair is the pad terminator key. However, pressing 
most of the alpha or numeric keys will have the same result. Keys which, when pressed, 
do not set the graphic beam at the position of the crosshair are the BREAK, CROSSHAIR, 
SHIFT, CONTROL, HOME, TTY LOCK, NUMERIC LOCK, and COMMAND LOCK OUT keys. 


Examples 
1ЕМАЫе «CR» 


Places the 4027 in GIN mode and sets the crosshair at the graphic beam position. 


CROSSHAIR 


A crosshair appears in the workspace 
when the 4027 is ENABLED. 


ЕМА 5<CR> 


Places the 4027 in GIN mode for the specified number of points (5) and sets the 
crosshair at the graphic beam position. An end-of-line sequence is sent, after five reports 
have been sent, which causes the crosshair to leave the screen and the 4027 to leave 
GIN mode. 
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DISABLE Command 
Syntax 


IDISAble «CR» 


Action 


The DISABLE command removes the 4027 from GIN mode. The crosshair is removed from 
the graphic area and the crosshair control keys return to controlling the alpha cursor. An 
end-of-line sequence is sent to the host as the terminator of the GIN messages, if any 
have been sent. 
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VECTOR Command 


When a graphic region of suitable size has been defined, vectors (line segments) can be 
drawn in the graphic region using the VECTOR command. 


Syntax 
IVECtor «X0» «YO» «X1» «Y1»[«X2» «Y2» ... «Xn» «Yn»]«CR» 


where all «X» апа « Y» parameters are positive integers. 


Action 


This command draws a vector from the point with graphic coordinates (« X0», « YO») to 
the point with coordinates (<Хі>, <Y1>). If additional pairs of coordinates are 
specified, additional vectors are drawn from (« X1», «Y1») to (<Х2>, <Ү2>), from 
(<Х2>, «Y2») to(<X3>, <Y3>),..., and finally from (<Х(п-1)>, «Y(n—1)») 

to(« Xn», « Yn»). All vectors are drawn in the color currently defined by the COLOR 
command. 


The «X» and «Y» coordinates are graphic region coordinates. If the value of «X» ог 
«Y» is not within the graphic region, the vector is "clipped;" that is, a line is drawn to 
the edge of the graphic region in the current direction. If another vector is drawn after this, 
the new vector is also clipped as it comes back into the window. 
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с 


Suppose you һауе used the "ОНА 10,19,20,49 « CR» command їо define the 240 140 
graphic region described earlier. The command 


МЕС 120,120 91,30 168,85 72,85 149,30 120,120 « CR» 
creates the following display. (Axes are not shown on the display.) Note that, since either 


a space or a comma serves as the separator, we have alternated these to emphasize the 
VECTOR coordinate pairs. 


(120,120) 


Ci cp. € Ке ELS. JE 


(168,85) 


C 


со 


(91,30) (149,30) 


Е 


МЕС 120,1 20,91,30,168,85,72,85,149,30,1 20,120 


2402-13 


Ғідиге 8-2. Тһе УЕСТОН Соттапа. 
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ВУЕСТОН (Relative Vector) Command 


It is possible to draw vectors by specifying relative coordinates — that is, coordinates 
relative to the last graphic beam position. This is done using the RVECTOR command. 


Syntax 


IRVEctor «rel XO» «rel YO» «rel X1» «rel Y1> 
[«rel X2» «rel Y2» ... «rel Xn» «rel Уп>| < CR» 


where «rel X» and «rel Y » are integers, not necessarily all positive. The parameters 
are separated by spaces or commas. 


START FINISH 
(120+0,65+55) = (120,120) = (149-29,30+90) 


2 


(169-96,85+0) = (72,85) (168,85) = (91+77,30+55) 


-- 


ORIGINAL VECTOR BEAM 
POSITIONED AT (120,65) 


қ 
(120-29,120--90) - (91,30) (149,30) = (72+77,85-55) 


ІНУЕ 0, 55,-29,-90,77,55,-96,0,77,-55,-29,90< CR» 


2402-14 


—3 


Figure 8-3. The RVECTOR Command. 
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Action 


This command draws one or more vectors in the graphic region, as does the VECTOR 
command. The pair <rel XO>, <rel YO> specifies coordinates relative to the current 
graphic beam position. Each succeeding pair of «rel X», «rel У > parameters specifies 
new coordinates relative to the preceding coordinate pair. All vectors are drawn in the 
color currently defined by the COLOR command. 


Example 


Suppose that the current graphic beam position is at the point with absolute workspace 
coordinates(120,65). The command: 


IRVE 0,55 —29,—90 77,55 —96,0 77,—55 —29,90« CR» 


draws the star in Figure 8-3. It is the same figure drawn by the earlier VECTOR command, 
but now each pair of coordinates given is relative to the preceding pair of coordinates. 


As in the VECTOR command, if a pair of coordinates specifies a point outside the graphic 
region, the 4027 will draw the vector only to the edge of the graphic region where it will be 
terminated or "clipped." The next line to be drawn will be drawn as though the entire 
vector was present. The clipping action has no effect on subsequent vectors. 
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LINE Command 


The 4027 can draw different styles of vectors. The style of vector is selected with the 
LINE command and will be drawn in the current vector color by the VECTOR command. 


Syntax 
ILINe [«line type>]<CR> 
where «line type» must be one of the following: 
€ A digit from 1 to 8, inclusive 
е The letter P 
е The letter E 


If «line type» is not specified, it defaults to one. 
Action 


This command sets the type of line used to draw vectors in subsequent VECTOR, 
RVECTOR, and CIRCLE commands. Line type 1 is a solid line, the default line type. Line 
types 2 through 8 are various styles of dashed lines. Line types 1 through 8 are shown in 
Figure 8-4. 


2401-23 


Figure 8-4. Vector LINE Types. 


Line type P causes subsequent VECTOR and RVECTOR commands to plot isolated points 
rather than connect the points with line segments. 


Line type E causes subsequent VECTOR and RVECTOR commands to draw vectors in the 
background color which effectively "erase" existing vectors. However, if a line that 
crosses a polygon is erased in this way, it will leave a background color line across the 


polygon. 
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POLYGON Command L 
A large number of shapes and panels may be drawn in color by the 4027 using the T 
POLYGON command. || 
Syntax | 
IPOLygon «X1» «Y1» «X2» «Y2» «X3» «Y3»[.«Xn» « Yn»]« CR» | 
мћеге 
<Х1 > is ап integer indicating а point on the horizontal axis which will be one of the | 


coordinates for one vertex of the polygon. 


<Y1> is an integer indicating a point on the vertical axis which will be the second L 
coordinate for one vertex of the polygon. Additional parameters define the 
succeeding vertices of the polygon. A minimum of 3 vertices are necessary to form a 
polygon. 


с 


Action ки 
Фи 


This command draws а polygon whose vertices are defined by Ше given parameters. This 
polygon is filled in with the current color (as defined by the COLOR command). 
Boundaries of polygons are drawn in the current line type, as defined by the LINE 
command. The vertices are given as in the VECTOR command; if the last vertex is not the 
same as the first vertex, then a closing edge is automatically drawn. If any edges cross, L 
the polygon will still be filled correctly. 


E 


Since a maximum of 53 lines may be allotted to the graphic region, the largest possible Y 
axis coordinate is 752 (14 X 53 = 752). 


г 


Refer to the GRAPHIC command discussion for further explanation of the graphic region 
coordinate system. 


E 
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Ехатріе 
IPOLygon 100,100,200,100,200,200,100,200 < СВ > 


Creates а polygon designated by the given vertices іп the current color as shown below. 


(100,200) (200,200) 


2 


(100,100) (200,100) 


!POL 100, 100, 200, 100, 200, 200, 100, 200<CR> 


2657-11 


一 а а 一】 
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RPOLYGON (Relative Polygon) Command 


The 4027 can draw polygons using relative coordinates (as in the RVECTOR command). 


Syntax 
RPOLygon <X1><Y1><X2><Y2><X3><Y3>L..<Xn><Yn>]<CR> 
where 


<X1> and <Y1> are coordinates relative to the current position of the crosshair 
and define the first point of the polygon. 

<Xn> and <Yn> are subsequent coordinates which define the other vertices of 
the polygon relative to the last given pair of coordinates. 


Action 


This command creates a filled polygon in the current vector and boundary color as does 
the POLYGON command. But the vertices are given in relative coordinates, as in the 
RVECTOR command. If the last vertex is not the same as the first, a closing edge is 
automatically created. Like the POLYGON command, the resulting filled area covers 
anything below it. If polygons overlap, the last one created is the one displayed in the 
overlapping area. 


THIRD VERTEX (—50,50) 
жай 


-+—— SECOND VERTEX (50,50) 


НЕ START (0,0) IS AT LOCATION 


OF THE CROSSHAIR. 


IRPOL 0,0 50,50 -50,50<СН> 
2657-12 


Figure 8-5а. Ап RPOLY Command Using 0,0 as the First Coordinate Pair. 
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IRPOLygon 0,0,50,50, — 50,50 « CR» 


Creates a triangle at the location of the crosshair in the current vector and boundary 
colors, as shown in Figure 8-5a. 


IRPOL 150,0,50,50,-50,50< CR» 
Creates a triangle. Its first coordinate pair is 150 points to the right of the crosshair 


position on the X axis. Subsequent vertices of the triangle are drawn relative to the 
position designated by the previous coordinate pair. Refer to Figure 8-5b. 


ue VERTEX (-50,50) 


150 -4— SECOND VERTEX 
POINTS — "| (50,50) 


TEC START (150,0) 


!RPOL 150,0 50,50 -50,50< CR» 
2657-13 


Figure 8-5b. An RPOLY Command Using 150,0 as the First Coordinate Pair. 
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PIE Command 


The 4027 can draw filled circles, circle sectors, or equilateral polygons using the PIE 
command. 


Syntax 
IPIE «radius» [<start angle»] [<end angle>] [<increment angle>]<CR> 
where 


<radius> is a positive integer representing the radius of the pie or polygon in raster 
units. A raster unit is one dot within a character cell. Refer to the GRAPHIC command 
(іп this section) for further explanation of dots and character cells. 


<start angle> is a positive or negative integer which states the angle at which the 
first radius is drawn. 


<end angle> is a positive or negative integer which states the angle at which the 
last radius is drawn. 


« increment angle> is a positive integer which represents the angle between points 
on the circumference that become vertices of a polygon. 


Action 


The PIE command causes a pie shape to be drawn, centered at the current crosshair 
position. The pie has a «radius» of the specified number of raster units and is filled with 
the current vector color and outlined in the current boundary color from the « start 
angle» to the «end angle». If the «start angle» and «end angle» are not given, О and 
360 degrees are the default values and a complete pie is drawn with the specified 
«radius». 


If «increment angle» is given, the PIE command creates a polygon with vertices every 
« increment angle degrees. These points are joined and become the vertices of a 
polygon. The default value for «increment angle» is 4 degrees. A polygon drawn with 
vertices this close together looks like a circle. 


All angles are measured with О degrees as the point of reference. Zero degrees is the 


horizontal line segment which extends from the center point to the point on the right side 
of the graphic area. Angle values increase in a direction moving counterclockwise. 
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Examples 
РЕ 1000 270<CR> 


Causes а pie to be drawn as shown below. Тһе <radius> is 100 raster units, < start 
angle» is О degrees, and «end angle» is 270 degrees. 


—=— (0°) START ANGLE 


CENTER 
POINT 


TS (270%) END ANGLE 


IPIE 100 0 270 < CR» 
2657-14 


IPIE 100 0 360 45 «CR» 


This command draws a polygon as shown below. The «radius» is 100 raster units, 
«start angle» is О degrees, and «end angle» is 360 degrees. Since the «increment 
angle of 45 degrees has been given, the pie is drawn as a polygon with 8 equal sides. 


P d (45%) INCREMENT ANGLE 


(0°) START ANGLE 


IN (360°) END ANGLE 


CENTER 
POINT 


IPIE 100 0 360 45<CR> 


2657-15 
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IPIE 100 0 360 90<CR> 


When this command is given the polygon shown below is drawn in the current boundary 
color and filled in the current vector color. The <radius>, <start angle>, and <end 
angle> are the same as in the previous example. With the <increment angle> set at 90 
degrees, a square polygon is drawn which is rotated 45 degrees from the X axis. 


4—7 (90°) INCREMENT ANGLE 


a (0°) START ANGLE 
““-- (360°) END ANGLE 


CENTER 
POINT 


IPIE 100 О 360 90<CR> 
2657-16 
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CIRCLE Command 


The CIRCLE command is used to create circles, circle sectors, and equilateral polygons, 
just as the PIE command. These shapes, however, are not filled; instead just the boundary 
is drawn in the current color. 


Syntax 
ICIRcle <radius> [<start angle>] [<end angle>] [<increment angle>]<CR> 
where 


<radius> is a positive integer representing the radius of the circle or polygon in 
raster units. 


<start angle> is a positive or negative integer which states the angle at which the 
first radius of the circle will be drawn. 


<end angle> is a positive or negative integer which states the angle at which the 
last radius of the circle will be drawn. 


<increment angle> is a positive integer which represents the number of degrees 
between the vertices of the polygon. 


Action 


The CIRCLE command creates various shapes in the same manner as the PIE command. 
The CIRCLE command causes a shape to be drawn around the beam position which, 
unlike the PIE command, is not filled with the current vector color. Only the boundary of 
the figure is made the current color. 


The circle (or polygon) will be drawn from the «start angle» to the «end angle» ata 
radius of «radius» raster units. If the «start angle» and «end angle» are not given, 
they default to O and 360 degrees, respectively. 


If «increment angle» is given, the CIRCLE command will mark vertices at intervals of 
« increment angle degrees. The vertices then are joined to form a polygon as in the PIE 
command. Default value for «increment angle» is 4 degrees. 


АП angles are measured with O degrees as the point of reference. Zero degrees is the 
horizontal line segment which extends from the center point to the right side of the 
graphic area. Angle values increase in a direction moving counter clockwise relative to 
zero degrees. 
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Examples 


ICIRcle 100 0 360<CR> 
ІСІН 100<CR> 


Creates a complete circle in the current vector color with a <radius> of 100 raster units, 
as shown below. 


°) START ANGLE 


(360°) END ANGLE 


CENTER 
POINT 


CIRCLE CREATED BY !CIR 100 0 360<CR> 
2657-17 


ІСІН 100 0 360 45<CR> 


Creates а polygon т the current vector color with a <radius> of 100 raster units. As 
shown below, including the <increment angle> of 45 degrees causes an eight-sided 
polygon to be formed. <Start angle> and <end angle> must be given when <increment 
angle> is used. 


(45°) INCREMENT ANGLE 


a 


0°) START ANGLE 
PA ) 


№ (360°) END ANGLE 


POLYGON CREATED BY !CIR 100 0 360 45<CR> 


2657-18 
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ІСІН 100 90 360<CR> 


Creates а sector of a circle with a <radius> of 100 raster units Нот the «start angle» 
of 90 degrees to the «end angle» of 360 degrees, as shown below. 


каз 222222 


ме“ (90°) START ANGLE 


Radius 
---- 100 Raster -->-)-4- (360°) END ANGLE 
Units 


ша Z3 


рика Ram | 


SHAPE CREATED ВУ !CIR 100 90 360 <CR> 
2657-19 


2 


Ха 222 
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INK Command 


The INK command enables the drawing of lines between points in the graphic area 
without typing in coordinates. The 4027 must be in the GIN mode to INK. 


Syntax 
ИМК [Yes | Мој < CR» 


If no parameter is specified, Yes is assumed. 


Action 


When the INK or INK YES command is given, the 4027 can draw lines from the present 
crosshair location to the previous location without designating the coordinates as in a 
VECTOR or RVECTOR command. The 4027 must be ENABLED by giving the ENABLE 
command or pressing the zero/crosshair key. After this has been done, pressing the pad 
terminator key or any other non-cursor moving key causes a line to be drawn from the 
present position of the crosshair to the previous position. 


The INK NO command turns INKing off. 


Example 
ПМК Уез< CR» 


Refer to Figure 8-6. When drawing a line from crosshair position one to position two, 
position one must first be established by moving the crosshair to the desired location and 
pressing the pad terminator key. Remember that the crosshair is displayed by giving the 
ENABLE command or pressing the crosshair key. When the crosshair first comes up, if 
INKing is already on, a line is drawn from the previous beam position to the crosshair 
position when the pad terminator key is pressed. 
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4027 GRAPHIC AREA 


PRESENT 
CROSSHAIR POSITION 


PREVIOUS 
CROSSHAIR POSITION 
LINE DRAWN IN CURRENT 


COLOR WHEN PAD TERMINATOR 
KEY PRESSED. 


2657-20 


Figure 8-6. Drawing a Line in INK mode. 


After the position of the crosshair has been established, give the INK command. Then, 
each time the crosshair is repositioned and the pad terminator key is pressed, a line is 
drawn between the present location of the crosshair and the previous one. Lines are 
drawn in the current vector color. If no color has been specified, lines are drawn in color 
number CO (default white). 


ПМК Noc CR» 


The INKing process is terminated. If INKing is off, then no vectors are drawn when points 
are set in GIN mode. 


If an ENABLE command for X points is given, after X points are entered, the crosshair 
goes down and INKing appears to terminate. However, INKing is still in effect and 
additional vectors will be INKed if the zero/crosshair key is pressed, returning the 
crosshair to the graphic region. INKing is terminated only by giving the INK NO command. 
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STRING Command 
Text may be entered in a graphic region directly from the keyboard or by using the 
STRING command. The STRING command allows text to be positioned relative to the 
displayed graphics using graphic coordinates. 
Syntax 

ISTRing «text» «CR» 
where «text» may be: 

1. One or more delimited ASCII strings. 

2. A sequence of ASCII Decimal Equivalents. 

3. Any combination of 1 and 2. 


The string defined by «text» should not contain the command character. 


Action 


This command inserts the string defined by the «text» parameter into the graphic 
region. The first character defined by «text» is displayed in the character cell containing 
the graphic beam. Succeeding characters of «text» are displayed in succeeding 
character cells. Any vectors or characters that were previously displayed in the character 
cells where «text is inserted are no longer visible, since each character of «text» fills 
an entire character cell. 


Example 


ISTRing/Triangle/ « CR» 


where "Triangle" is a delimited ASCII string which will be displayed at the position of the 
graphic beam. 
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Triangle 


шр | 


[GRAPHIC 1,35 
'УЕСТОК 0,0 300,0 150,200 0,0 


A^ !VECTOR 120, 80 
« 'STRING "Triangle" 


(2402) 2657-21 


Figure 8-7. The STRING Command. 
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ЕВАЗЕ а Соттапа 


When the information displayed т a graphic region is no longer needed, it can be deleted 
in one of two ways. You can delete the graphic region and all information stored in it from 
the workspace display list. You can also erase the graphic information but leave the 
graphic region defined to display new graphic information. 


To delete the graphic region from the display list, give the ERASE WORKSPACE 
command. The graphic region, along with all other information in the workspace, is 
deleted from the display list. No further graphic commands can be executed until a new 
graphic region is defined by a GRAPHIC command. 


If you wish to reuse the same graphic region, the ERASE а command is used. The ERASE 
G command can include a color number or pattern number which will cause the graphic 
area to be flooded (erased) with the specified color or pattern. 


Syntax 


!ERAse [G [raphics] [< color number>|<pattern number>]]<CR> 


С. 


Action 


This command causes the graphic area to be erased. If the parameters include a color 
number (СО-С7) or pattern number (PO-P119), the color or pattern becomes the 
background color. The current vector and panel drawing color is not changed. The ERASE 
GRAPHICS command does not reallocate the graphic memory cells at the top of Font 31. 


E C 


Е 


МОТЕ 
The ERASE command can also be used to erase the contents of the || 
workspace or monitor. Refer to the Controlling the Display section for 
details. | 
U 
L 
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Examples 
ЕВА G<CR> 

Erases the contents of the graphic area containing the graphic cursor. 
ЕВА G C1« CR» 

Erases the contents of the graphic area with color C1. 
ЕВА С P1 «CR» 


Erases the contents of the graphic area with pattern P1. 
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SHRINK Command 


When using 4010-style graphics it is necessary for the 4027 to alter the coordinates of 
graphic information in its display list. 


The 4027 can accept 4010-style graphic commands from a host computer. In 4010-style 
graphic commands, the X-coordinates can be as great as 1023. The X-coordinates in a 
4027 graphic commands should not exceed 639 (in a graphic region occupying all 80 
columns). It is necessary, therefore, to scale incoming 4010-style graphic commands for 
display in the 4027 graphic region. (See discussion of 4010-style graphics in this 
section.) 


Syntax 


ISHRink [Yes | Hardcopy | Both | No] «CR» 


The default parameter is Yes. 


Action 


X" 


SHRINK YES. This command causes the 4027 to "shrink" X- and Y-coordinates in 
subsequent VECTOR, RVECTOR, POLY, RPOLY, CIRCLE and PIE commands, multiplying 
them by a factor of approximately 5/8. This accommodates the 4027 to the range of 
possible coordinates in 4010-style graphics commands. The SHRINK YES command also 
sets the appropriate output condition for transmitting DATA coordinates in graphic input 
mode. 


C C C 


To use the 4027 to execute a 4010-style graphic command file, first dimension the 
graphic region to hold 35 rows of 80 columns. (ОВА 1,35,1,80 ог "ОНА 10,44 are two 
GRAPHIC commands which do this.) Then give a SHRINK YES command to put the 4027 
in graphics shrink mode. 


C 


NOTE 
SHRINK HARDCOPY and SHRINK BOTH commands are included only for 


compatibility with programs written for the 4025. These commands are not 
recommended for programs written for the 4027. 


SHRINK NO. This command removes the 4027 from shrink mode. 


С 
C к C C C. 
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EFFECTS OF A GRAPHIC REGION 


The presence of a graphic region affects the action of some of the 4027 commands and 
keys, summarized here: 


DELETE CHARACTER: Inside a graphic region, the character is replaced by a space. 


DELETE LINE: Ina line which passes through a graphic region, only characters outside 
the graphic region are deleted. Information inside the graphic region is not deleted. 


ERASE & SKIP: па line that passes through a graphic region, only characters outside 
the graphic region are deleted. 


ERASE WORKSPACE: This erases the entire workspace, including the graphic region 
definition. Anew GRAPHIC command must be given before new graphics can be 
displayed. 


CURSOR MOVEMENT AND TYPING: The ASCII keys, the cursor movement keys and 
commands, and the scrolling keys and commands are not affected by the presence of the 
graphic region. If the cursor is moved into a graphic region and a character typed on the 
keyboard, that character replaces graphic information previously stored in the character 
cell. Entering GIN mode causes the cursor movement keys to control the movement of the 
crosshair instead of the cursor. 


FORM FILLOUT MODE: All locations within the graphic region are protected in form 
fillout mode. If a graphic region is less than 80 columns wide and no form exists in the 
side region(s), the area to the left of the form is unprotected (text may be entered) but all 
other areas outside the form are protected and text may not be entered in them. To 
prevent text from being entered into the unprotected area of the field, expand the graphic 
area so that it will begin at column 1. 


ATTRIBUTE CODES: Inside a graphic region, the 4027 inserts only font attribute codes 
in the display list. All other attributes are ignored. Any visual attributes (enhanced, etc.) 
which are in effect at the left edge of the graphic region affect the entire row of character 
cells running through the graphic region. Logical attributes and font codes in effect at the 
left edge of the graphic region do not affect the graphic region itself, but characters to the 
right of the graphic region are given these same font and logical attributes. 


THE SEND COMMAND: Graphic information in a graphic region is not transmitted by the 
SEND command. Every character cell containing graphic information is transmitted as an 
ASCII space. Text information is sent, however. 
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Suppose the graph shown in Figure 8-8 is displayed in the workspace. 
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Figure 8-8. А Graphic Display. 


E 


If you do a SEND operation to the computer, then SEND back from the computer to the 
terminal, you obtain the display in Figure 8-9. No information generated by graphic 
commands was sent to the computer. The display in Figure 8-9 is what is stored in the 
computer. 
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Figure 8-9. A Graphic Display After the SEND Command. 
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4010-STYLE GRAPHICS ON THE 4027 


The 4027 with standard Graphics Memory, accepts 4010-style graphic commands when 
these commands are sent from the host. (The 4027 does not accept 4010-style graphic 
commands entered on the keyboard.) 4010-style graphics are characterized by 
addressable screen coordinates and the use of ASCII characters to encode these 
addresses. 


To enable the 4027 to respond properly to 4010-style graphic commands, issue the 
commands 


IGRAPHIC 1,35 « CR» 
ISHRINK < CR» 


These set up a graphics region which is correctly proportioned to display 4010-style 
graphics. Specifically, the addressable graphic region is approximately 640X by 490Y, in 
4027 workspace coordinates (1024X by 784Y in 4010 coordinates). (See the SHRINK 
command discussion earlier in this section.) 


In 4010-style graphics, certain control characters are interpreted by the terminal as 
graphic commands. The following 4010-style commands from the host cause the 4027 to 
change operating modes: 


1. The GS command places the 4027 in 4010-style graph mode. 


2. The US command exits the 4027 from graph mode and positions the cursor at the 
character cell containing the graphic beam. 


3. The ESC command notifies the 4027 that the next character should be interpreted 
as a command. This command has no effect if the terminal is in 4010-style 
graphic mode. 


4. The ESC-Form Feed command erases the current graphics region if the terminal 
is in US mode. 


Addressing the Graphic Beam 


The graphic beam is moved to a point in the graphic region by sending to the terminal the 
binary equivalents of the Y address and the X address (4010 coordinate addresses) of 
the point. Each binary equivalent is separated into two parts: the five most significant bits 
and the five least significant bits. The address 205Y,148X translates to 0011001 101 Y, 
0010010100X (binary). The 0011001101Y becomes 00110 HiY and 01101 LoY; the 
0010010100X becomes 00100 HiX and 10100 LoX. In graph mode, these bytes cause 
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the beam to be moved to the 205Y,148X position in the graphic region. To be sent to the 
4027, these bytes must be encoded as ASCII equivalents. The 00110 НУ bit is encoded 
as ап ASCII “%” symbol, which has binary representation 0100110. The first two bits, 01, 
instruct the terminal that this is a HiY address. The last five bits, 00110, form the HiY 
segment of the Y address 0011001101. 205Y, 148X is encoded as “&т$Т.” Appendix C 
is a Coordinate Conversion Chart for encoding X- and Y-coordinates as ASCII characters. 
Refer to Section 5 for an explanation of the Delete Ignore feature as controlled by the PAD 
command. 


Graph Mode Memory 


When an address is sent to the terminal, the НТУ, LoY and НХ bytes are stored т a 
register. If the next address sent to the terminal repeats some of these bytes, they need 
not be retransmitted. LoX must always be sent, since the command is not executed until 
LoX is received. Even if the 4027 leaves graph mode and reenters it later, these three 
bytes are retained. The following table shows which bytes must be sent in response to 
specific byte changes. 


Table 8-1 


4010-STYLE GRAPHICS REQUIRED BYTE TRANSMISSIONS 


Bytes Bytes which must be transmitted 

Which 

Change Hi Y Lo Y Hi X Lo X 
Hi Y # # 
Lo Y # # 
Hi X # # # 
Lo X # 


When the 4027 exits 4010-style graph mode, the communications port is returned to the 
portion of display memory it was in before entering graph mode (workspace or monitor). 


For a complete discussion of 4010-style graphics, see the 4010 Series documentation. 
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ALTERNATE CHARACTER FONTS 


The 4027 graphics memory may be used to store alternate character fonts, defined by the 
user for special purposes. 


With its full 192K of graphics memory (Option 29), the 4027 can accommodate up to 32 
different fonts, each containing up to 128 characters. Thirty-one of these fonts may be 
user-defined. (The standard font is Font 0 and cannot be modified by the 4027 operator 
or by the computer.) In addition to the standard font, two other predefined fonts are 
available: Ruling Characters (Option 32) and Math Characters (Option 34). 


NOTE 


Font 31 is used to store user-defined patterns. AFONT 31 command will 
cause an error condition. 


Alternate character fonts are defined by the FONT command or on a character by 
character basis with the SYMBOL command. 
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SYMBOL Command 
Syntax 


ISYMbol «number» <font>[<background color по. >] [«foreground color по. >] 
[<value 1>]... [<value 14>][<foreground color no.>][<value1>]... 
[<value 14>]]<CR> 


where 


<number> is an integer between 0 and 127, inclusive, or any of the ASCII 
characters. 


<font> is an integer between 1 and 31, inclusive. 


<background color no.> is a color number, CO-C7, which designates the color of 
the dots which will not be a part of the symbol. 


<foreground color no.> is a color number, CO-C7, which designates the color of the 
dots which form the symbol. 


Each <value n> is an integer from 0 to 255 which specifies which dots in a 
particular row will be the foreground color. 


The <font> parameter must specify a character font for which graphics memory is 
installed. (The operator can discover which character fonts have graphics memory 
installed with the GTEST command, discussed in the System Status and Initialization 
section.) Each <value n> parameter defaults to zero. 


Action 


This command defines a symbol in character font <font>. The <number> parameter is 
the ASCII decimal equivalent of some ASCII character. The ASCII character itself may be 
used. The symbol defined by this command is displayed whenever the specified ASCII 
character is entered in a field with font attribute «font». 


The symbol is defined by specifying which dots in the 8 x 14 character cell matrix are 
lighted in the «foreground color» when the symbol is displayed. Each «value n» 
parameter is converted into an 8-bit binary equivalent. The zero/one pattern of this binary 
equivalent determines which of the eight dots in the n-th row of the character cell are 
lighted in the «foreground color when this character is displayed. 


Rows and dots within a row which are not used to form the symbol will be displayed in the 
« background color or, if none is specified, will default to color C7 (default black). 
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Example 
The command 

ISYM 97,30,C1,C2,0,0,0,0,2,52,72,72,52,2,0,255<CR> 

or 

ISYM а,30,С1,С2,0,0,0,0,2,52,72,72,52,2,0,255 « CR» 
defines character 97 of font 30. The number 97 is the ASCII Decimal Equivalent of the 
ASCII character “а”. When the “а” character is entered in a field with font attribute 30, the 
symbol defined by this command is displayed. The symbol is displayed in color C2 and all 


dots which are not used to form the symbol are displayed in the «background color» СТ. 
Figure 8-10 illustrates this symbol and how the SYMBOL command defines it. 
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Binary Equivalent Dot Pattern 


| 
Qo Non-Symbol Area is 


< Background Color> 


оо 
ооо ; 
O Om OOOO 


ol 
ооо 
= 


-一 一 Symbol Area is 
<Foreground Color > 


ole - 
oOo2ooooooooooo 


T 
1 


оо -ооо[оо 
ооо! 
сөз 
| 一 ооз 


| 
| 


Default j 
Default 


о 
оозо-оооо-оооо 


оо 


(2402) 2657-23 


Figure 8-10. А User-Defined Symbol. 


If one wishes to clear symbol 97 from user-defined font 30, the command 
ISYM 97,30,C7 < CR» 


is given. АП rows іп the character cell matrix аге set to zero, and this symbol is displayed 


as a space, with all matrix dot color C7. | 
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IFONT [<hardware font>] <font number» [<background color >] [<foreground 
color>]<CR> 
where 


« hardware font is the number of the font to be copied. Default is the regular ASCII 
font, font O. 


<font number» is ап integer between 1 and 31 which represents some font in 
graphic memory. 


« background color» is the color or pattern of the background. 


« foreground color is the color or pattern for the characters. 


NOTE 


Font 31 is reserved for user-defined patterns set by the PATTERN 
command. Font 31 is illegal and if used an error condition will occur. The 
a terminal must be powered off or RESET to remove the error condition. 


Action 


This command copies the <hardware font> into the given font, if it exists, in the given 
colors. If the «hardware font» is not specified, the regular ASCII font (font 0) is used. 
This entry is only valid if the optional Character Set Expansion board (Option 31) is 
installed. The two color numbers specify the colors to be used for background and 
foreground. They may be either a color number (CO-C7) or a pattern number (PO-P1 19). If 
the colors are omitted they default to the default foreground and background colors (CO 
on C7). Fonts should be defined before drawing graphics to avoid altering the graphic 
area. 


The ATTRIBUTE command is used to display the font at the position of the alpha cursor. 
Refer to the Forms and Form Fillout section for information describing the ATTRIBUTE 
command. 


Example 


IFONt 0,30, 0C1,CA « CR» 


Copies the hardware font (О) into font 30 in «background color» C1 and «foreground 


А color> C4. 


=A 


4027 PROGRAMMER'S @ 8-37 


一 了 


GRAPHICS 
DFONT COMMAND 


8-38 


DFONT (Delete Font) Command 
The graphics memory used to store symbol definitions in a user-defined character font 
can be released for another use by giving the DFONT command. 
NOTE 

Font 31 should be deleted with care. Font 31 is used to store patterns 

defined by the PATTERN command. Deleting Font 31 destroys any stored 

patterns. 
Syntax 

IDFOnt «font» «CR» 


where «font» is an integer between 1 and 31, inclusive. 


Action 


The DFONT command deletes the symbol definitions in the programmable font. The space 
may be used for graphics when the font has been deleted. When the Character Set 
Expansion board (Option 31) is installed, the ATTRIBUTE command allows specification 
of a font number. Deleting font 31 does not affect the top eight characters. This allows the 
user to reuse the low characters, but not disturb the palette of possible vector and panel 
colors. 


Example 
The command 
IDFO 30<CR> 


Allows memory used to store symbol definitions now to be used to store graphics or 
another character set. 
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COMMANDS DISCUSSED ІМ THIS SECTION: 


Form Fillout Mode 


FORM Соттпапа....................................... 


Creating Fields 


ATTRIBUTE Соттапа................................. 
JUMP Соттапа....................................... 


Rulings 


HRULE (Horizontal Rule) Соттапа..................... 
VRULE (Vertical rule) Command ........................ 


Additional Commands 


ВАСКТАВ Соттапа................................... 
ERASE Соттапа...................................... 
FIELD Соттапа....................................... 
JUMP Соттапа....................................... 
SEND Соттапа....................................... 
ТАВ:-Соттапа....:222.22-2-5. бета ні кеі 
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FORMS AND FORM FILLOUT 


From the operator’s viewpoint, a form consists of several lines of text displayed in the 
workspace and formatted in a particular way. A form is divided into blanks areas, which 


There may also be horizontal and vertical ruling lines to emphasize the structure of the 
form. The operator fills in the blanks with appropriate data and sends this data to the 
computer for storage or processing. 


A sample form used to store a customer’s name and address is shown in Figure 9-1. 
the blanks shaded gray. In typical applications, these blanks could be spaces or colored 
areas on the screen. 


Customer "5 Name 


Street Address 


City 


State 


Figure 9-1. Sample Form. 


FORM FILLOUT MODE 


A form is filled out and the data in the form sent to the computer while the 4027 is in form 
fillout mode. 


Form fillout mode has several features designed to make it easy to fill out and process 
forms. 


е Data can be entered only in the blanks of the form. These blanks are called 
unprotected fields. If the operator attempts to enter a character in a protected 
field, the terminal bell sounds and the character is inserted in the next 
unprotected field in the form. 
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the operator fills in, and labels, which identify the type of data to be entered in each blank. 


9-1 


FORMS АМО FORM FILLOUT 
FORM FILLOUT MODE 


е Several keys on the keyboard behave differently when the keyboard types into the 
workspace. The TAB key moves the cursor to the beginning of the next 
unprotected field of the form. The BK TAB key moves the cursor to the beginning 
of the current field. The HOME key moves the cursor to the beginning of the first 
unprotected field in the form, rather than to column 1 of row 1 of the workspace. 
The ERASE key erases only the data in the unprotected fields; protected fields are 
not erased. 


е Several of the 4027 commands have effects other than the usual ones. When the 
computer types into the workspace, the TAB, BACKTAB, and ERASE commands 
have the same effects as the corresponding keys. The editing commands also 
behave differently. These differences are detailed, command by command, 
throughout this section and later sections. 

A typical form fillout application includes the following steps: 

ө Insure that the terminal is not in form fillout mode. 

ө Display the form in the 4027 workspace. Either the operator creates the form from 
the keyboard or, more often, a stored form is sent from the computer or tape unit to 
the workspace. Both processes are the same from the terminal’s viewpoint. 

ө Put the terminal into form fillout mode. 


@ Fill out the form. 


ө Send the data in the form to the computer (or a printer, a tape unit, or a hard copy 
unit). 


ө Erase the unprotected fields of the form and fill it out again; then send the new 
data in the form to the computer. Repeat this process as long as necessary. 


@ When the form is no longer needed, remove the terminal from form fillout mode 
and erase the form itself from the screen. 


The FORM command is used to place the 4027 in form fillout mode and to remove it from 
form fillout mode. 
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FORM Command 


Syntax 
IFORm | Yes|No]<CR> 


If no parameter is specified, Yes is assumed. 


Action 
If Yes is specified, the 4027 is placed in form fillout mode. If No is specified, the 4027 is 
removed from form fillout mode. 
Examples 
IFOR« CR» Places the 4027 in form fillout mode. 
IFOR У< CR» 


IFORM YES«CR» 


IFORN«CR» Removes the 4027 from form fillout mode. 
IFORM NO« CR» 
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CREATING A FORM 


From the 4027’s viewpoint, there is more to a form than meets the eye. Consider the 
sample form in Figure 9-2. This form consists of several lines of text. Each line is divided 
into one or more sections called fields; each field is divided into individual character 
positions. 


Customer "5 Мате 
Street Address 


City 


State 


LINES 


Zip Code 


[И [street Address ][ 


FIELDS 


(2402) 2657-24 


Figure 9-2. The Parts of a Form. 
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To display a form, the 4027 stores the information which defines the form in the portion of 
memory called the workspace display list. Іп addition to the characters which аге 
displayed on the screen, the display list includes markers which are not displayed. These 
markers are of two types: 


ө End-of-line markers which indicate where one line of text ends and the next 
begins. 


ө Markers called attribute codes. Attribute codes divided a line into fields and 
determine the properties, or attributes, of those fields. 


The fourth line of the sample form appears on the screen as follows: 


| Street Address 


2402-20 


To the workspace display list, however, the following information is stored: 


<ATT> [| <АТТ> [1] <АТТ> | Street Address | <АТТ> 880 <АТТ> [1] <END-OF-LINE = 


4th 5th 
FIELD FIELD 
ATTRIBUTE CODES 


(NOT VISIBLE ON THE SCREEN 
BUT INCLUDED IN THE DISPLAY LIST) 


2402-21 


To create a form you must complete the following steps: 


е Decide what each line of the form is to look like—what attributes each field will 
possess; what text, if any, will be printed in the protected fields. 


• Attach attribute codes to each field so that when the 4027 displays the form, each 
field will have the desired attributes and the form, as a whole, will have the desired 


appearance. 


€ Type desired text into protected fields. 
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FIELD ATTRIBUTES AND FIELD ATTRIBUTE CODES 


There are three classes of field attributes: 
е Character font attributes: font zero, font one, font two, etc. 


ө Logical attributes: alphanumeric, numeric, protected, and protected modified. 
Alphanumeric and numeric denote unprotected fields into which the operator can 
enter data. 


ө Visual attributes: the characters and background may be assigned any of the 
color numbers (CO-C7). Characters and background colors may be inverted and 
also made to blink between colors. 4025-style visual attributes (standard, 
enhanced, inverted, and underscored) may also be used. 


Font Attributes 


А 4027 font attribute is an integer between 0 and 31, inclusive. The integer designates 
the character font from which characters are selected for display in the field. The default 
font attribute is 0. Font 0 is called the standard font and consists of the 128 characters of 
the ASCII code. Font 1 is always the Ruling Characters font (Option 32); Font 3 is the 
Math Characters font (Option 34) if it is installed. On the 4027, other fonts may be 
determined by ROMs inserted in the Character Set Expansion Board (Option 31), or may 
be defined by the user with SYMBOL and FONT commands which are described in 

the Graphics section. 


NOTE 


Font 31 is used to store user-defined patterns. AFONT 31 command (see 
Graphics section) causes an error condition. 


If a font attribute is specified for which no character font is defined, each character in the 
font is displayed as a rectangle with all the dots in that character cell matrix turned on in 
random fashion. 


NOTE 


Font attributes in the display list affect the display, whether the terminal is 
in form fillout mode or not. A field with font attribute 1, for example, 
displays characters from font 1 at all times (assuming Option 32 is 
present). 
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Logical Attributes 


The logical attributes which a field can possess are as follows: 


Symbol Used Attribute Meaning 


The default logical attribute. Specifies an alphan- 
umeric unprotected field into which any alphanu- 
meric character may be entered. 


Alphanumeric 


Specifies a numeric unprotected field. In form 
fillout mode, only characters with ADEs 32-63 
can be entered in a numeric field. (This includes 
the numerals 0-9, and most punctuation sym- 
bols.) 


Numeric 


Protected Specifies a protected field. In form fillout mode, a 
protected field cannot be typed into or erased. 


Note that the fields of the form to be filled in by the operator must be unprotected fields, 
with logical attributes A or N; labels and areas in which the operator is not to type should 
be protected. 


Each field possesses one of these logical attributes. In addition, any field may possess 
the logical attribute M, for “modified.” The SEND MOD command sends to the computer 
the data in those, and only those, fields which have been flagged as “modified” with the 
logical attribute M. (See the discussion of the SEND command later in this section.) 


A field may be flagged as "modified" in either of two ways: 


ө When the data іп any unprotected field is changed, the terminal automatically 
attaches the logical attribute M to that field. The next SEND MOD command sends 
the data in that field to the computer and removes the M attribute. The data in this 
field is not sent to the computer again until it has been modified again in some 
way and the field once again flagged with the logical attribute M. 


е The ATTRIBUTE command may specify the logical attribute PM, for protected 
modified." A SEND MOD command sends the data in such a field to the computer, 
but does not remove the M attribute; thus a PM field is sent to the computer with 
every SEND MOD command. 


NOTE 


Logical attributes have effect only when the 4027 is in form fillout mode. 
When not in form fillout mode, the 4027 ignores logical attributes. 
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Visual Attributes 


On the 4027, the ATTRIBUTE command is used to give various visual attributes to the 
characters and their backgrounds. Characters and backgrounds may be assigned any of 
the eight color numbers (CO-C7), they may be inverted, or they may be made to blink 
between two visual attributes. 


Color Attributes 


On the 4027, visual attributes are used to select the color of the characters and the color 
of the background as listed below. 


ГАТТ CO is color О (default white) on color 7. (default black) 
1АТТ C1 is color 1 (default red) on color 7. 

1АТТ C2 is color 2 (default green) on color 7. 

"АТТ СЗ is color З (default blue) on color 7. 

ГАТТ СА is color 4 (default yellow) on color 7. 

ГАТТ C5 is color 5 (default cyan) on color 7. 

1АТТ Сб is color 6 (default magenta) on color 7. 

'АТТ С7 is color 7 (default black) on color 7. (Invisible) 


Inverted Attributes 


Characters and backgrounds may be inverted by using “1” and a color number as listed 
below. Default colors for the color numbers are the same as listed under the color 
attribute descriptions. 


IATT ICO is color 7 on color 0. 
ГАТТ IC1 is color 7 on color 1. 
IATT IC2 is color 7 on color 2. 
ГАТТ (СЗ is color 7 on color З. 
ГАТТ ICA is color 7 on color 4. 
ГАТТ IC5 is color 7 on color 5. 
!ATT IC6 is color 7 on color 6. 
IATT IC7 is color 7 on color 7. (Invisible) 


The actual color displayed by each of the eight color names may be controlled by the 
color commands; MAP, RMAP, and MIX. 
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Blinking Attributes 
The 4027 can blink between two colors or between inverted and non-inverted by putting a 
hyphen (-) between the desired parameters. For example, the command 

'АТТ C2-C4 


causes the characters to blink between color numbers C2 and C4 on а C7 background. 
Blinking will not occur within a graphic area. 


4025-Style Visual Attributes 


4025-style attributes may be used to run a program on the 4027 which was written for the 
4025. The 4025 uses visual attibutes designated S, E, U, and |, and these parameter 
forms may be used on the 4027. The 4025 visual attributes correspond to 4027 color 
attributes as listed below: 


S (Standard) = со IE (Inverted, Enhanced) = |С2 
| (Inverted) = |CO IU (Inverted, Underscore) = |СД 
E (Enhanced) = C2 EU (Enhanced, Underscore) = C6 
U (Underscore) - C4 IEU (Inverted, Enhanced, 
Упдегзсоге) = 1С6 
МОТЕ 


Like font attributes, visual attributes affect the display even when the 4027 
is not in form fillout mode. 


Field Attribute Codes Within a Line 


Unless instructed otherwise by an ATTRIBUTE command, the 4027 begins each line with 
the default attribute in each class: font 0, alphanumeric logical attribute, and CO visual 
attribute. 


An attribute code may specify attributes from one, two or all three classes of field 
attributes. As the 4027 scans each line in its display list, it searches for attribute codes. 
When it encounters a new attribute code, it modifies only the class or classes of attributes 
specified in this new code; the other class or classes of attributes are not modified. 
Suppose, for example, the following line is stored in the display list: 


<font 0,protected,C2> 一 一 一 一 一 一 一 一 一 一 一 一 一 一 <numeric> 一 一 一 一 一 一 <CR> 


Since the second attribute code specifies only the logical attribute numeric, the second 
field is displayed in font 0, C2 (the font and visual attributes of the preceding field). 
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CREATING FIELDS 


Each field in a line is created by specifying the font, logical, and visual attributes which 
the field possesses. The ATTRIBUTE command is used for this purpose. 


ATTRIBUTE Command 


Syntax 
!ATTribute [<font>] [<logical >] [<visual>[-<visual>]]<CR> 


where <font> denotes a font attribute, <logical> denotes a logical attribute, and each 
<visual> denotes one or more visual attributes. 


Action 


The ATTRIBUTE command inserts a field attribute code into the workspace display list at 
the cursor position. This field attribute code marks the beginning of a new field and 
designates the font, logical, and visual attributes of this field, as specified in the 
ATTRIBUTE command. If this field is the first field in the line, the ATTRIBUTE command 
specifies the attributes of the field which differ from the default attributes. If the field is 
preceded by another field on the same line, the ATTRIBUTE command specifies the 
attributes of the new field which differ from those of the preceding field. If two visual 
attributes or sets of attributes are separated by a hyphen, the display blinks that field 
between the two specified visual attributes or sets of visual attributes. The display will not 
blink between visual attributes within a graphic area. 


Restrictions on Syntax 


For the 4027, <font> is an integer between O and 31, inclusive. <font> defaults to O (at 
the beginning of a line) or to the font attribute of the preceding field. 


For the 4027, 
«logical» = [ А | М|Р | РМ | 


where A denotes alphanumeric, М denotes numeric, Р denotes protected, and PM denotes 
protected modified. These parameters must be given in this single letter form. 


<Logical> defaults to A (at the beginning of a line) ог to the logical attribute of the 
preceding field. 
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For the 4027, 


«visual» = [<color name» | І<соіог name>] 
and 
-<visual> = -[<color name> | I«color name>] 


where <color name> is a color number CO-C7 and | denotes inverted. The order of the 
color names does not affect the display. Also, the 4025-style attributes (S, E, |, and U) 
may be used in place of <color name>. 


If the -<visual> parameter is specified, the display blinks between the two attributes or 
sets of attributes specified. For example, visual attributes of C2-C4 cause the field to 


blink between C2 and C4 visual attributes. 


For the 4027, <visual> defaults to CO (at the beginning of a line) or to the visual 
attribute(s) of the preceding field. 


When using 4025-style attributes (S, Е, Ц, |), no spaces are allowed between alphabetic 
parameters in the ATTRIBUTE command. To define a protected field with the enhanced 
and inverted visual attributes, for example, give the command 

1АТТ PEI<CR> 


To blink that field between the enhanced and inverted visual attributes, give the command 


IATT PE-I C CR» 


Examples of ATTRIBUTE Commands 
Font Attributes 


IATT O «CR» Defines a new field beginning at the cursor position. When 
ГАТТ «CR» characters are entered in this field, the field displays characters 
from Font O, the standard font. 


ГАТТ 1<CR> Defines a new field beginning at the cursor position. When 
characters are entered in this field, the field displays the 
corresponding character from Font 1, the Ruling Characters font. 
(Requires Option 32.) 
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ГАТТ 1 С4<СВ> Defines a new field beginning at the workspace cursor position. 


IATT 30<CR> 


Logical Attributes 


IATT A<CR> 


ПАТТ N<CR> 


IATT P<CR> 


IATT PM<CR> 


Visual Attributes 


1АТТ CO<CR> 


АТТ C2<CR> 


ГАТТ ICO<CR> 


When characters are displayed in this field, it displays the 
corresponding characters in color C4 from character Font 1 
(ruling characters). (Requires Option 32.) 


Defines a new field beginning at the workspace cursor position. 
When characters are entered in this field, the field displays 
characters from Font 30. The characteristics of Font 30 must 
first have been set by the FONT command which is described in 
the Graphics section. Fonts 1 through 31 are user definable, but 
Font 31 is reserved for patterns and, if used, results in an error 
condition. 


Defines an alphanumeric unprotected field beginning at the 
cursor position. 


Defines a numeric unprotected field beginning at the cursor 
position. In form fillout mode, only characters with ADEs 32-63 
can appear in this field. 


Defines a protected field, beginning at the cursor position. In 
form fillout mode, this field cannot be typed into or erased. 


Defines a protected modified field beginning at the cursor 
position. This field is transmitted to the computer with any 
subsequent SEND MOD command. 


Defines a new field beginning at the cursor position. Displays 
that field with the standard visual attribute of color CO on color 
C7. 


Defines a new field beginning at the cursor position. Displays 
that field with the enhanced visual attribute of color C2 on color 
C7. 


Defines a new field beginning at the cursor position. Displays 
that field with the inverted visual attribute of color C7 on color 
СО. 
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ГАТТ C4<CR> Defines a new field beginning at the cursor position. Displays 
that field with the underscored visual attribute of color C4 on 
color C7. 


1АТТ C2-CO« CR» Defines a new field beginning at the cursor position and blinks 
that field between the visual attributes C2 and C4. This provides 
blinking between color CO and color C2 on color C7. 


IATT IC2-C4<CR> Defines a new field beginning at the cursor position and blinks 
that field between the visual attributes of inverted C2 with C4. 
This provides characters blinking between C4 and C7 with 
background blinking between CO and C2. 


IATT C3-IC4 « CR» Displays the field beginning at the cursor position with the 
inverted attribute and alternate blinking between the specific 
colors. The dash before the inverted attribute creates the 


blinking attribute. The attribute will appear as colors C3 and C7 
on a background of colors C4 and C7. 


IATT PMS-C6 « CR» Sets up a protected field, labels it "modified" for SEND MOD 
operations, and causes it to be displayed as a blinking between 
colors CO and C6. 


Creating Fields with JUMP 


The JUMP command can be used with the ATTRIBUTE command to create several fields 
on one line. Suppose you want to create a protected C2 field 60 character positions in 
length in row 3 of the workspace. The command 


МОМ З!АТТ РС2;—————— (60 spaces) 一 一 一 一 一 一 <CR> 
creates the desired field. However, the command 
МОМ З!АТТ РС2ШОМ 3,60!АТТ PCO<CR> 


creates the desired field more quickly and with more efficient coding. 
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The JUMP command can be used to create several fields on one line of the workspace. 
Suppose you want row 5 to appear as follows: 


Field 1 


1 га 
PROTECTED PROTECTED NUMERIC 
Color cO Color c2 Color c4 


(2402) 2657-25 


This can be done by transmitting the fields as series of spaces, as in our first example. 
But the command sequence 


МИМ БІАТТ PCO;Field 1!JUM 5,20!ATT PC2!JUM 5,50!ATT NC4;Field 3— — — «CR» 


gives the same display and transmits fewer characters than sending the first two fields as 
series of spaces. 


Suppose the workspace cursor is in the home position (row 1, column 1) and consider the 
three command sequences: 


1. !ATT P;Name !АТТ AC2!JUM 1,25!АТТ PCO<CR> 
2. "АТТР;Мате !ATT AC2!JUM 1,25!ATT CO!JUM 1,60!АТТ PCO<CR> 
3. !"АТТР:Мате !ATT AC2!JUM 1,25!ATT PCO!JUM 1,80!ATT PCO < СВ > 


When executed, each of these command sequences causes the same display: 


2402-23 


Each sequence, however, creates a very different “line” in the 4027 display list, and the 
differences between them are important when the 4027 is in form fillout mode. 


The line generated by sequence 1. ends in column 25; the display list contains nothing 
beyond that column. If the operator moves the cursor right of column 25 in line 1 and 
presses a key, the cursor moves to the beginning of the next unprotected field and prints 
the typed character there. The terminal bell does not ring. 
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The line generated by 2. ends in column 60. Columns 26 through 60 constitute an 
unprotected field. If the operator types in these columns, the text is printed just as it is 
typed. 


The line generated by 3. ends in column 80; all 80 columns of the screen are included in 
this line. Columns 26 through 80 constitute a protected field. If the operator moves the 
cursor into this field and types a character, the terminal bell rings, the cursor moves to the 
beginning of the next unprotected field in the form, and the character is printed there. 


When using the JUMP command to create fields, always “Не down” the 
line with the [ATT PCO command, as shown in the preceding examples. If 
this is not done, the display list may not include the last field created with 
JUMP. 
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RULINGS 


You can highlight the structure of a form by drawing rulings, or ruling lines. The 4027 with 
the Ruling Characters font (Option 32) has two provisions for doing this. First, the basic 
command set includes the HRULE (Horizontal Rule) and VRULE (Vertical Rule) 
commands. Second, the Ruling Characters font (Option 32) itself provides additional 
ruling characters for making junctions between horizontal and vertical rulings. 


Horizontal and vertical rulings can be made any of the 64 colors by assigning a visual 
attribute to each line or location at which the ruling appears. When making horizontal 
rulings, assigning a visual attribute works well since the attribute can be made to color 
the entire row in the display. When visual attributes are given to vertical rulings, however, 
they must be given for each row in which the vertical ruling appears. 


HRULE (Horizontal Rule) Command (Requires Option 32) 


Syntax 


IHRUIe «row» «column? [<length> [<width>] ]<CR> 


where all parameters are positive integers. The <row> and <column> parameters give 
absolute workspace coordinates (as in the JUMP command). Since there are only 80 
columns, the <column> parameter must not exceed 80 and the sum of <column> and 
<length> must not exceed 81. The <width> parameter, if specified, must be either 1 or 
2. The default value for both <length> and <width> is 1. 


Action 


This command draws a horizontal ruling in the workspace. The first character of the ruling 
is inserted at the row and column specified by the <row> and <column> parameters. 
The ruling continues to the right for a total of <length> columns. This ruling is a single 
line if <width> is 1 and a double line if <width> is 2. 


Examples 

IHRU 3,5,20 « CR» Beginning at row 3, column 5 of the work- 

IHRU 3,5,20,1 < CR» space, draws a horizontal ruling through 20 
columns (columns 5 through 24). The ruling 
is a single line. 

IHRU 3,5,20,2< CR» Beginning at row 3, column 5 of the 
workspace, draws a horizontal ruling through 
20 columns (columns 5 through 24). The - 
ruling is a double line. Q 
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VRULE (Vertical Rule) Command (Requires Option 32) 


Syntax 
IVRUIe «row» «column» [<length> [<width>] ] CR» 


where all parameters are positive integers. The «row» and «column» parameters аге 
absolute workspace coordinates (as in the JUMP command). The «column» parameter 
may not exceed 80. The «width > parameter, if specified, must be either 1 or 2. The 
default value of both «length and «width» is 1. 


Action 


This command draws a vertical ruling in the workspace. The first ruling character is 
inserted at the row and column specified by the «row and «column? parameters. The 
ruling continues downward for a total of «length rows. If «width is 1 (or omitted), the 
ruling is a single line; if « width is 2, the ruling is a double line. 


Examples 
IVRU 3,5,20< CR» Beginning at row 3, column 5 of the work- 
МВО 3,5,20,1 < CR» space, draws a vertical ruling through 20 
rows (rows 3 through 22). This ruling is a 
single line. 
IVRU 3,5,20,2 « CR» Beginning at row 3, column 5 of the work- 


space, draws a vertical ruling through 20 
rows (rows 3 through 22). This ruling is a 
double line. 


NOTE 


If the 4027 receives an HRULE or VRULE command but does not contain 
Option 32, each character cell affected by the command is displayed as a 
rectangle with all its matrix dots turned off (black). 
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Making Correct Junctions 


While the HRULE and VRULE command are convenient, vertical and horizontal rulings 
drawn with these commands do not cross or join each other. Each ruling character 
occupies an entire character cell on the display, and a character cell which contains a 
vertical ruling character cannot contain a horizontal ruling character. For example, 
suppose you give the following sequence of commands: 


IVRU 3,20,10,1 «CR» 
IVRU 3,30,10,1 «CR» 
IVRU 3,40,10,1 «CR» 
IVRU 3,50,10,1 «CR» 
IVRU 3,60,10,1 «CR» 
"НВО 3,20,41,1 « CR» 
IHRU 5,20,41,2 < CR» 
IHRU 12,20,41,1 < СА > 


At this point, the basic structure of the form has been created, but the junctions between 
horizontal and vertical rulings need to be added. The workspace display appears as 
follows: 


The variety of ruling characters provided in the Ruling Characters Font (Option 32) allows 
the programmer or operator to make neat, well-fitted junctions by selecting appropriate 
font characters. The Ruling Junctions Chart (Figure 9-3) is a reference sheet for making 
junctions on the 4027. With it you can make junctions for this sample form with the 
sequence of commands: 


190М3,20; @!JUM3,30;A!JUM3,40;A!JUM3,50;A!JUM3,60;B < CR» 
!JUMS,20; \ 1JUM5,30;K1!JUMS5,40;K1JUMS5,50;K!JUMS5,60; < CR» 
IJUM12,20;P!JUM1 2,30;Q!JUM1 2,40;Q!JUM12,50;Q!JUM12,60;R« CR» 
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Now the form looks like this: 


A complete table of ruling characters is given in Appendix D. 


4024/4025 Rulings 


Standard Rulings 
|_ Fomo | 0) (Font т 


Rulings 
(Font 1) 
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Figure 9-3. Rulings Junction Chart. 
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THE EFFECT OF FORM FILLOUT ON 4027 COMMANDS 


Form fillout mode alters the action of some of the 4027 commands, but does not affect the 
action of others. For commands discussed in later sections, any effects of form fillout 
mode on a command are discussed when the command is introduced. Some of the display 
control commands already discussed are affected by form fillout mode: 


е The ТАВ, BACKTAB, and ERASE commands (and their corresponding keys) are 
affected by form fillout mode. 


ө The UP, DOWN, RIGHT, LEFT, RUP, and RDOWN commands (and their corre- 
sponding keys) are not affected by form fillout mode. The JUMP command is not 
affected by form fillout mode, but is still useful for working with forms. 


The following discussion assumes that the 4027 is in form fillout mode, that commands 
come from the computer, and that text from the computer is directed into the workspace. 


Typing in Form Fillout 


When the 4027 is in form fillout mode, text can be entered only in the unprotected fields 
of the form. If the operator types a character while the 4027 is in form fillout mode, text 
can be entered only in the unprotected fields of the form. If the operator types a character 
while the workspace cursor is in a protected field, the terminal bell rings and the typed 
character is inserted in the first column of the next unprotected field in the form. 


If the cursor is in the last column of an unprotected field and the operator types а 
character, the character is inserted in that column and the cursor moves to the first 
column of the next unprotected field of the form. 


И the cursor is moved beyond the last field in a line (using JUMP ог a cursor key) and a 
character is typed, the cursor moves to the beginning of the next unprotected field in the 
form and the typed character is entered there. In this case, the terminal bell does not ring. 
(See the Creating Fields with JUMP discussion earlier in this section.) 


When a form is created, a line of the form may consist only of a carriage return, <CR>. 
Such a line contains no protected or unprotected fields; it appears on the terminal screen 
as а blank line, but in the workspace display list only a <CR > is stored. If the cursor is 
positioned anywhere in such a line and a character is typed, the cursor moves to the 
beginning of the next unprotected field in the form; the terminal bell does not ring. 


If the cursor is moved beyond the last unprotected field in the form and a key is pressed, 
the cursor moves to column 1 of the last line in the workspace window. The typed 
character is not displayed. 
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TAB in Form Fillout 


Each tab character advances the workspace cursor to the beginning of the next 
unprotected field in the form. If the cursor is in the last unprotected field of the form, the 
next tab character sends the cursor to the home position at the beginning of the first 
unprotected field. 


Examples 


Suppose the sample form shown below is displayed in the workspace, with the cursor 
positioned as shown. 


Name John Doe 9 ТҰТ 


CURSOR ——————- Ш 
Height 6 ft. 4 in. Weight 220 lbs. 


Social Security Number 000- 00- 0000 


2402-24 


1. Тһе command 
ТАВ< CR» 


moves the cursor to the beginning of the next unprotected field. 


Name John Doe Age а ours. 
в ~——____ CURSOR AFTER 


Height 6 ft. 4 in. Weight 220 lbs. TAR «CR» 


Social Security Number 000- 00- 0000 


2402-25 
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2. Тһе subsequent command 
ТАВ 4<CR> 


advances the cursor four unprotected fields and positions it as shown. 


Name John Doe | | Рае — yrs. 


Height 6 ft. 4 in. Weight 220 lbs. 


Social Security Number E 


3. The subsequent command 
'ТАВ 3<CR> 


advances the cursor through the last two unprotected fields of the form and 
back to the home position. 


CURSORINHOME Мате John Doe Age 22 yrs. 
POSITION AFTER 


ПРВИ Height 6 ft. 4 in. Weight 228 lbs. 


Social Security Number 000- BO- 0000 


2402-27 
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ВАСКТАВ in Form Fillout 


A BACKTAB character moves the cursor to the beginning of the unprotected field in 
which it is located. If the cursor is already at the start of an unprotected field, or if it is not 
inside an unprotected field, a BACKTAB character moves the cursor to the start of the 
preceding unprotected field. If the cursor is already at the start of the first unprotected 
field in the form, a BACKTAB character leaves the cursor where it is. 


Examples 


Suppose the cursor is positioned in the last unprotected field of our sample form, as 
shown. 


| Age 22 yrs. 
Height 6 ft. 4 in. Weight 1228 lbs. 
Social Security Number 000- 00- 0000 н 


2402-28 


1.Тһе соттапа 
IBAC «CR» 


moves the cursor to the beginning of the unprotected field in which it is located. 


Name John Doe Age 22 yrs. 
Height КБ ft. F in. Weight 220 | 


Social Security Number 0 


2402-29 
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2. Any of the subsequent commands 


ВАС 7<CR> 
ВАС 8<CR> 
ВАС 9<CR> 


moves the cursor through all the preceding seven fields of the form, to the 
beginning of the first unprotected field. 


CURSOR ——— 


Height 6 ft. 4 in. Weight 220 lbs. 
Social Security Number 000- 00- 0000 


2402-30 
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ERASE in Form Fillout 

In form fillout mode, the ERASE command erases only the contents of the unprotected 
fields in the form and leaves the cursor at the beginning of the first unprotected field. 
Example 


Suppose a sample form is filled out as shown and the information in the form is sent to the 
computer. 


Name John Doe | Age 22 yrs. 


Height 6 ft. 4 in. Weight 220 lbs. 
Social Security Number 000- 00- 0000 


2402-31 


The command 


ЕВА W<CR> 


erases the contents of the form and leaves the cursor positioned as shown. 


Name 727 12 c fige im yrs. 
cursor ———— № 


Height ft. in. Weight 


Social Security Number | 


2402-32 


The command 
|ЕВА < СЕ > 


also does this if, аз we assume here, the device issuing the command 
(computer or keyboard) also types into the workspace. 
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The HOME Key and JUMP in Form Fillout 
When the 4027 is not in form fillout mode, the command 
IJUM<CR> 


has the same effect as pressing the HOME key. In each case, the workspace cursor 
moves to row 1, column 1, the "home" position. 


In form fillout mode, pressing the HOME key moves the cursor to the beginning of the first 
unprotected field in the form, which generally does not begin in row 1, column 1. But the 
JUMP command has no respect for form fillout mode. Giving the command 


IJUM «CR» ог 
МОМ 1,1 «CR» 


moves the cursor to row 1, column 1, whether or not that field is protected, unprotected, or 
even part of the form. 


The JUMP command can still be used, with the TAB command, to simulate the action of 
the HOME key. As long as row 1, column 1 is a protected location, the sequence of 
commands 


IJUMITAB« CR» 


moves the cursor first to row 1, column 1 (!JUM), then to the beginning of the first 
unprotected field in the form (ITAB). 
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TRANSMITTING FORMS AND FORM DATA 


Because of the formatted nature of forms and form data, special care must be taken when 
transmitting either to the computer. The SEND command and the FIELD command have 
been specially designed for transmitting form information. 


SEND in Form Fillout 


Syntax 

ISENd [All | Mod] c CR» 
The default parameter is All; that is, "SEN « CR» is equivalent to ISEN Ac CR». 
There are two uses of the SEND command involving forms. 


First, suppose the operator has constructed a form in the workspace and wishes to store 
this form in the computer. (The 4027 with Option 4 can also store forms or form data on a 
Tektronix 4924 Digital Cartridge Tape Drive. See the Peripherals section.) After making 
sure that the 4027 is not in form fillout mode, the operator gives the SEND command. (If 
the 4027 is not in form fillout mode, the SEND, SEND ALL, and SEND MOD commands are 
equivalent.) This command sends all the information in the workspace to the computer. 
Field attribute codes in the workspace display list are automatically encoded as 
ATTRIBUTE commands; thus, when the form is sent back to the 4027 from the computer, 
the 4027 has the information necessary to reconstruct the form. 


Second, suppose a form is displayed, the terminal is placed in form fillout mode, and the 
form is filled out. The operator now wishes to send the data in the form (not the form itself) 
to the computer for storage or processing. With the 4027 in form fillout mode, the operator 
uses either the SEND ALL command or the SEND MOD command. 


The SEND ALL command sends to the computer the data in each unprotected field of the 
form. 


The SEND MOD command sends to the computer the data in just those fields flagged with 
the logical attribute M (modified). In this case, the data in a field is sent to the computer if 
and only if (1) the field is an unprotected field whose contents have been changed since 
the last SEND or SEND MOD command, or (2) the field is a protected field permanently 
flagged with the logical attribute PM (protected modified). 
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When a SEND MOD command is given, then, consecutive blocks of data may not come 
from consecutive unprotected fields in the form. For the applications program to process 
the data correctly, however, it must know the form location from which each block of data 
comes. Therefore, when a SEND MOD command is executed, the data from each modified 
field is sent to the computer, preceded by a pair of three-digit numbers separated by a 
comma. These numbers specify, in absolute workspace coordinates, the row (first 
number) and column (second number) of the first character position of the field. Suppose, 
for example, a modified field begins in row 5, column 3. When the data in this field is sent 
to the computer, it is preceded by the string 005,003. Examples of transmissions using 
the SEND MOD command appear later in this section. 


The commands or keyboard operations which affect the contents of a form are ERASE 
WORKSPACE, DELETE CHARACTER, DELETE LINE, ERASE & SKIP, or the additions and 
changes made to the unprotected fields. 


For 4027 instruments with version 1.2 firmware: 

The source of the !ERA W, !DCH, ог !IDLI commands, as well as any updates to the 
contents of the form, determines the affect on the logical attribute modified flag. If these 
commands or updates are given from the host computer, the fields are NOT flagged as 
modified. Any keyboard operation, however, which affects the status of unprotected fields, 
flags those fields to be transmitted on the next SEND MODIFIED command. 


In the case of the keyboard ERASE of the workspace, or the |ЕВА W command from the 
keyboard, all unprotected fields are marked as modified and are transmitted with the row 
and column position on the next SEND MODIFIED. This informs the host that information 
has been removed from the screen. 
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FIELD in Form Fillout 


Syntax 
"НЕ [<separator>]<CR> 


where «separator is a single printing ASCII character or а two- or three-digit ADE of an 
ASCII character. If no «separator» is specified, it is assumed to be NUL, whose ADE is 
00. 


Action 


The FIELD command sets the field separator. If any non-NUL field separator is specified, 
that character precedes the data sent to the computer from each field; trailing spaces are 
not transmitted. 


If no field separator (or the NUL separator) is specified, all the data in each field is 
transmitted to the computer by a SEND (ALL or MOD) command. If a field is not 
completely filled out, all the spaces at the end of the field are treated as data and sent to 
the computer, along with the rest of the data in the field. 


The 4027 remembers its field separator when powered off or RESET. 


Examples 

ІНЕ @<CR> Sets the field separator to the @ character, 

ІНЕ 64<CR> whose ADE is 64. 

ІНЕ 9<CR> Sets the field separator to the ASCII charac- 
ter 9. 

ІНЕ O9<CR> Sets the field separator to the ASCII HT 
(horizontal tab) character, whose ADE is 09. 

IFIE<CR> Sets the field separator to NUL. When data 
in a field is sent to the computer, no field 
separator is used. 
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Some Sample Transmissions 


Suppose the following form begins in row 1 of the workspace. The unprotected fields are 
attribute C2 (shown here shaded gray); the last unprotected field has logical attribute 
numeric. The end of each non-blank line is at the end of the last unprotected field in the 
line. The three lines containing unprotected fields are separated from each other by blank 
lines. 


Name 


Address 


City 


2402-33 


To store this form in the computer, give the command 


ISEN<CR> 


IATT P;————Name !ATT С2А; ------------------- <CR>!ATT 
P<CR> 


АТТ P;—Address !ATT С2А; ------------------- <CR>!ATT 
P<CR> 


!АТТР:————Ойу ВАТТ Os - на IATT $Р; — 5!аје: АТТ С2А; ——— 
бара ы қақы ІАТТ SP;—ZIP АТТ C2N; ———— «CR» 


Transmitted spaces аге shown here аз dashes. Remember that the default logical 
attribute of lines 2 and 4 (the blank lines) is alphanumeric. These lines must be protected 
to prevent text from being entered in them. 


Suppose now the 4027 is placed in form fillout mode and the form is filled out. 


9-30 REV A, JUN 1980 4027 РВООВАММЕН 5 


The following information is sent to the computer: O | 


FORMS AND FORM FILLOUT 
SAMPLE TRANSMISSIONS 


2402-34 


If no field separator is specified, the command 
ISEN A<CR> 
sends the following data to the computer: 


John Doe 一 一 一 一 一 一 一 一 一 一 一 一 <CR>1111—W.—First—St.———— 
<CR>Anytown———Oregon——00000<CR> 


No field separator is used and each field is sent, including all trailing spaces. In 
a programming language which can divide an incoming line into blocks of 
predetermined length (such as COBOL), this is a convenient format. 


Suppose the field separator is the number sign, (#). The command 
ISEN A<CR> 
now sends the following to the computer 


#John—Doe<CR> #1111—W.—First—St.<CR> #Anytown #Oregon 
#00000<CR> 


The host program must use the # character to distinguish data from different 
fields. 


Suppose that the same form is filled out for John Doe’s sister, Jane Doe, who 
lives at a different street address in Anytown. Instead of erasing the form, the 
operator presses the HOME key to return the cursor to the first unprotected 
field, and simply types over the old information which must be changed. 
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Name Jane Doe 
Address 9999 W. Ninth St. . 


City Anytown State Oregon ZIP 00000 


2402-35 


Now the first two unprotected fields are flagged with the logical attribute M. The 
SEND MOD command sends the data in these fields to the computer. 


If no field separator is specified, the command 
ISEN M<CR> 
sends the following data to the computer: 


001,010Jane 一 Doe 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
<CR>003,01 09999W.—Ninth—St.<CR> 


Note that no spaces or other characters separate the row and column 
identifiers from the first character in the field. 


4. Finally suppose the form is filled out for John’s brother, Brad Doe, with no street 
address information provided, and the City and ZIP information modified: 


Name Brad Doe 


fiddress 


City Sometoun State Oregon ZIP 99999 


2402-36 


If the field separator is the # character, the command 
ISEN М<СН> 
sends the following data to the computer: 


$001,010Brad— Doe < CR» «003,010 « CR» #005,0105отегомп #005,010 
99999 «CR» 
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COMMANDS DISCUSSED IN THIS SECTION: 


Text—Editing Commands 


DCHAR (Delete Character) Соттапа...................................... 10-1 
DLINE (Delete Line) Соптапа............................................. 10-6 
ICHAR (Insert Character) Command ....................................... 10-3 
(LINE Позей Ling) Command... она наведи dancer кз 10-10 
@ 4027 PROGRAMMER'S 


Section 10 


TEXT EDITING 


THE TEXT-EDITING COMMANDS 


The 4027 recognizes four commands designed specifically for text editing: DCHAR 
(Delete Character), ICHAR (Insert Character), DLINE (Delete Line), and ILINE (Insert Line). 


NOTE 
If an editing command is typed on the keyboard and text from the keyboard 
is printed in the monitor, execution of the command inserts a blank line 


just below the line on which the command is typed. All examples deal with 
the workspace display. 


DCHAR (Delete Character) Command 


Syntax 
IDCHar [<count>]<CR> 


where <count< is a positive integer. If <count> is not specified, it defaults to one. 


Action 


This command deletes <count> characters, beginning with the character at the cursor 
position. As each character is deleted, characters to the right of the cursor shift left to fill 
the gap. The cursor does not move. If the terminal is in form fillout mode, only characters 
to the right of the cursor in the same field shift left. If the terminal is not in form fillout 
mode, all characters right of the cursor on the same line shift left. 


This command is equivalent to pressing the DELETE CHARACTER key <count> times. 


4027 PROGRAMMER'S © 


10-1 


TEXT EDITING 
DCHAR COMMAND 


Examples 


Suppose the following text is displayed in the workspace, with the cursor position as 
indicated: 


Everything seems seems in order. 
The command 
IDCH<CR> 
or 
IDCH1 «CR» 
deletes the s at the cursor position, leaving the following display: 
Everything seems gems in order. 
The subsequent command 
IDCH5 «CR» 
leaves the desired display: 
Everything seems (п огаег. 
Suppose a form contains incorrect information іп ап unprotected field; with the cursor 
positioned as shown: 
Name: Jane Dog DoeAge: 23 
The command: 
IDCH4 « CR» 
deletes the middle “Doe” and the extra space. Neighboring fields аге not affected: 


Name: Jane Doe, Age: 23 
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ICHAR (Insert Character) Command 
Syntax 


ПСНаг<СНВ> 


Action 


The ICHAR command places the 4027 in insert mode. This command is equivalent to 
pressing the INSERT MODE key. 


In insert mode, when new text is sent from the computer or typed on the keyboard, the 
cursor, the character at the cursor position, and characters to the right of the cursor are 
shifted right to make room for the new text. 
Suppose the text 
END BAGE 
is displayed in the workspace, with the cursor positioned as shown. If the string 
ПСН;ОЕ 
is sent from the computer, it inserts the text OF (including а space) and displays the text 
END OF PAGE 
п 
їп the workspace, with the cursor positioned to the left of the line. 
If the string 


НСН;ОЕ «CR» 


is typed from the keyboard, the <СВ> is sent to the workspace as text, and the cursor is 
positioned at the beginning of the next line: 


END OF PAGE 
a 
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In form fillout mode, only characters in the unprotected field containing the cursor are 
shifted right. Characters shifted past the rightmost position in that field are lost. 


The DCHAR key can be used to delete unwanted characters at or to the right of the cursor 
position, WITHOUT leaving insert mode. 


Any other cursor movement, resulting either from giving a command or from pressing a 
key, will cause the 4027 to leave insert mode. 


Examples 


Suppose the terminal is in form fillout mode and the following form is displayed, with the 
cursor positioned as shown. The only unprotected fields are the three inverted fields; all 
other fields are protected. 


NAME: Ebenezer Scrooge Age: 77 


Position Applied for: Miser 


If the string O 


ПСН; А 


is sent from the computer the following display results 


NAME: Ebenezer A ScroogeAge: 77 


Position Applied for: Miser 


The subsequent string 
ПСН;Бег 
sent from the computer results in the form fillout display 


Name: Ebenezer Aber ScroAge: 77 


Position Applied for: Miser 
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Finally, the string: 
ПОН;паіһу 


sent from the computer, moves the cursor past the end of the first unprotected field and 
into the second unprotected field. The following first lines of the form will be seen in rapid 
succession: 


Name: Ebenezer Abern ScrAge: 
Name: Ebenezer Aberna ScAge: 


Name: Ebenezer Abernat SAge: 


Name: Ebenezer Abernath Age: 
Name: Ebenezer AbernathyAge: 


BARRAN 


If the second unprotected field has the A (alphanumeric) attribute, any further insertion of 
characters shifts characters in the second field to the right and the old characters are 
lost. If the string 


IICH;B 
is sent from the computer, the following display results: 


Name: Ebenezer AbernathyAge: Ва 
Position Applied for: Miser 


However, if the second unprotected field has the N (numeric) attribute, a subsequent 
ICHAR command which inserts alphabetic characters moves the cursor to the first 
position of the numeric field, rings the bell, and does not insert succeeding characters. 


If the insert character operation moves the cursor past the last unprotected field on the 
form, the cursor moves to the beginning of the first unprotected field which can accept the 
new characters; the new characters are inserted in that field. 
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DLINE (Delete Line) Command 
Syntax 
пе [<count>]<CR> 


where <count> is a positive integer. If <count> is not specified, it defaults to one. 


Action 


If the 4027 is not in form fillout mode, this command deletes <count> consecutive lines 
of text, including the line containing the cursor. If the cursor is in the middle of a line, the 
entire line is deleted. As each line is deleted, the lines below roll up to fill the gap. 


In form fillout mode, this command erases the contents of all unprotected fields in 
<count> lines of the form. The line containing the cursor is counted as a deleted line, 
whether or not it contains any unprotected fields. After this line, only lines containing at 
least one unprotected field are counted as deleted lines. The cursor is positioned at the 
beginning of the next unprotected field, after the last field is erased. 


This command is equivalent to pressing the DELETE LINE key <count> times. 


Examples 


Suppose the terminal is not in form fillout mode, and 


the workspace contains the text shown, with the This mt cao uibs: 
cursor in line 2, column 8: This is Line 4 — 


This is Line 5 
This is Line 6 


The command 
IDLI 3X CR» 


gives the workspace display shown here: 


This is Line 1 
his is Line 9 — CURSOR POSITION 
AFTER !DLI 3 СВ-- 


С е 
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Suppose the terminal is in form fillout mode, and the workspace holds the form shown 
here. The unprotected fields are enhanced (shown here shaded gray): 


Name John Doe 
т 


Date June 1, 1978 | 
Position Applied For Office Manager | 
References 

Bill Brown | 

Carol Crane 

Dan Desi: 


2402-37 


If the cursor is positioned anywhere in the first line of the form, the command 
IDLI<CR> 


results in the display shown below. 


Name 
cursor arter | абе June 1, 1978 
саи Position Applied For Office Manager 


References 


Bill Brown 


Carol Crane 


Dan Dean _ 


2402-38 
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The subsequent command 
IDLI3<CR> 


results in the display shown here. Note that the line “References” is not counted as a 
deleted line, since it contains no unprotected fields. 


Position Applied For 


References 


CURSOR AFTER = , 


IDLI3<CR> | = 


2402-39 


Suppose you begin with the form shown below апа the cursor positioned as shown: 


Name John Doe 0 
Date June 1, 1978 
Position Applied For Office Manager — 


CURSOR References 


POSITION 


Bill Broun 


2402-40 


10-8 @ 4027 PROGRAMMER'S 


е е 
p 


TEXT EDITING 
DLINE COMMAND 


The command 
IDLI3<CR> 


results in the display shown here. Observe that the line which originally contained the 
cursor has been counted as the first deleted line, even though it contains no unprotected 
fields: 


Position Applied For Office Manager 


References 


LINES ERASED) 


CURSOR AFTER 
IDLE 3<CR> 
2402-41 
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ILINE (Insert Line) Command 
Syntax 
ІШпе [<count>]<CR> 
where <count> is a positive integer. If <count> is not specified, it defaults to one. 
Action 


This command inserts <count> blank lines into the text immediately below the line 
containing the cursor. The cursor is positioned at the beginning of the newest line. Lines 
of text below the cursor position are rolled down to make room for the inserted blank 
lines, and the scroll is lengthened so that these lines are saved in the display list. 


This command is equivalent to pressing the INSERT LINE key <count> times. 


The ILINE command makes it easy to insert new text between lines of old text. Use the 
ILINE command to create several blank lines at the desired location. Type the new 
information into the blank lines; and use the DLINE command to delete any blank lines 
left over. 


NOTE 


For text editing applications, the first line entered into the workspace 
should always be blank. If new text must be inserted above the old text, the 
cursor is moved to the beginning of the workspace and the ILINE 
command is used to create space for the new text. If the first line of the 
workspace already contains text, this procedure inserts blank lines below 
the first line of old text, rather than above it. 


Examples 


Suppose the workspace contains the text shown 
opposite, with the cursor positioned as shown: 


CURSOR POSITION 


@ 4027 PROGRAMMER'S 


TEXT EDITING 
ILINE COMMAND 


The command 
IILI 3<CR> 
inserts three blank lines between line 2 and line 3, 


leaving the cursor in column 1 of the newest blank 
line: 


AFTER !ILI3<CR> 


-------------- 


When the 4027 is in form fillout mode, the |ИМЕ command has по effect. 
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COMMANDS DISCUSSED ІМ THIS SECTION: 


Initializing the 4027 


PERIPHERALS Command ........................................... 
REPORT Соттапа................................................. 
SET Command civics eee ку e ен лев қалса ции lace IRA 


Communicating with Peripherals 


ALLOCATE Соттапа................................................ 
COPY Command ener euer b Wosbee d 
DIRECTORY Соттапа............................................... 
КІШІ Commandoraden oa ғанына Estee tae бо CHE S EE 
PASS Соттапа анода никна ade vm ACER аша кеі 


Copying on a Hardcopy Unit 


HCOPY (Hard Copy) Соттапа...................................... 
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PERIPHERALS 


The 4027 supports the following peripherals: 


ө With Option 3 (RS-232 Peripheral Interface), the 4027 supports a Tektronix 4642 
Printer and other compatible printers. 


е With Option 4 (GPIB Interface), the 4027 supports up to four Tektronix 4924 
Digital Cartridge Tape Drives and up to two Tektronix 4662 Interactive Digital 
Plotters. 


ө With Option 42 (Hard Copy and Video Out), the 4027 supports the Tektronix 4632 
Video Hard Copy Unit. 


Throughout this section the term “devices” is used. This term always refers to one of the 
following: а peripheral device such as the printer ог a tape unit, the host computer, the 
4027 monitor, or the 4027 workspace. These devices are specified by device mnemonics 


2 


as follows: 
П Device Mnemonic 
| Printer Por PR 
Tape Units 1-4 TA1-TA4 (TA1 may be shortened to T) 
Piotters 1,2 PL1, PL2 
П 4027 Мопйог Мог МО 
4027 Workspace W or WO 
Host Computer H or HO 
INITIALIZING THE 4027 FOR PERIPHERAL 
П COMMUNICATIONS 


Before the 4027 can copy file information from one device to another, it must be correctly 
informed about the status of the various peripheral devices attached to it. SET commands 
are used to initialize the 4027 for communicating with peripheral devices. The SET 
command should be given for those and only those peripheral devices present and 
powered up. 


二 -了 


2 
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SET Command (Requires Option 3 or 4) 
Syntax 

ІЗЕТ «device» « parameter» | < рагатейег> | < СВ > 
мћеге 


<device> is а опе to three-letter device mnemonic, апа <parameter> is a parameter 
setting for the indicated device. The form of each <parameter> depends on which 


peripheral device is specified. 


Do not attempt to set parameters for devices which are not attached to the 
4027 and powered up. Giving such a SET command may disable all 
communications to the 4027 and require the 4027 to be reset. 


Printer Parameters (Requires Option 3) 


The 4027 comes from the factory set for communicating with a Tektronix 4642 Printer. 
There are two parameters, however, which can be set to allow the 4027 to communicate 
with printers other than the 4642 Printer. 


% Some printers recognize the ASCII form feed character (<FF>) as a signal to 
begin a new page; other printers do not. On such printers a series of line feeds 
(«LF s) must be sent to begin a new page. Тһе 4027 can be set to send either 
the ASCII form feed («FF») character or the proper number of ASCII line feed 
(<LF>) characters to cause the printer to begin a new page. 


е The "carriage return, line feed" mechanical operation which the printer uses to 
begin a new line is relatively slow, compared to 4027 data transmission speeds. 
Thus the 4027 has "printer delay" parameter which can be set. After the 4027 
sends a «CR» <|Е> or «FF» to the printer, it waits a specified length of time 
before sending another character. This gives the printer time to complete its 
mechanical functions before having to cope with new text to be printed. 
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The command which SETs the 4027 for printer communications has the following form: 


where: 


ISET PR [Е | L][<delay>]<CR> 


F stands for “form feed,” and instructs the 4027 to use a <FF> character as a 
page separator. 


L stands for "line feed,” and instructs the 4027 to replace any «FF» character to 
the printer by the number of <LF>s required to begin a new page. 


е <delay> gives the printer delay. If <delay> is а positive integer, after the 4027 
sends а «CR», <LF>, ог «FF» to the printer, it waits «delay» tenths of a 
second before sending the next character. If «delay > =0, the 4027 communi- 
cates with the printer using "flagged simplex protocol." This means that after the 
4027 has sent a < CR», «LF»,or «FF» to the printer, it waits for the RS-232 
DTR (Data Terminal Ready) signal to become true before sending the next 
character. 

Examples 

ISET PR F 3<CR> Instructs the 4027 to use a form feed 
character («FF») as the page separator; 
when the printer receives a «FF», it begins 
a new page. This command also sets the 
printer delay to 0.3 seconds; after sending a 
«CR», «LF»,or «FF» tothe printer, the 
4027 waits 0.3 seconds before sending 
another character. 

ІЗЕТ PR L<CR> Instructs the 4027 that the printer does not 
treat a «FF» character as the page separa- 
tor. The 4027 replaces а «FF» with the 
number of <LF> s required to begin a new 
page. 

ISET PR O0<CR> Instructs the 4027 to communicate with the 
printer using flagged simplex protocol. After 
sending a «CR», «LF»,or «FF», the 
4027 waits for a DTR (Data Terminal Ready) 
signal from the printer before sending an- 
other character. 
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Tape Unit Parameters (Requires Option 4) 


To prepare the 4027 to communicate with a 4924 Digital Cartridge Tape Drive (hereafter 
referred to as a "tape unit"), three parameters must be set. 


€ Since the 4027 can have up to four tape units connected to it, each tape drive is 
numbered: tape unit 1, tape unit 2, tape unit 3, or tape unit 4. 


e The 4924 is a GPIB device; that is, the 4027 communicates with it using a GPIB 
(General Purpose Interface Bus). Each tape unit has two GPIB addresses: a 
command address and a data address. Since a tape unit's command address is 
always numerically just one larger than its data address, only the data address 
must be set. The GPIB data address of a tape unit must be set to an even number 
between 2 and 28, inclusive. This address must be physically set by switches on 
the back of the tape unit itself. But the 4027 must also be SET to send messages 
to the proper GPIB address. (See the 4027 Operator's Manual Peripheral Devices 
section for operating procedures.) 


е The tape unit can record information in one of two formats. One format is 
compatible with the Tektronix 4050 Series Graphic System internal tape drive. 
This is the format normally used to store file information for the 4027, and is 
called “4051 -сотранБ!е format." 


The other format is compatible with the Tektronix 4923 Digital Cartridge Tape 


Recorder. This format should be used only if you must exchange tape cartridges 
with a 4923. 


The command which initializes the 4027 for communicating with a tape unit has the 
following format: 


ISET «device» «address» [4051 | 4923] < С] > 
where: 


« device» is one of the following: (ТА | ТА? | ТАЗ | ТА4). This identifies the given 
device as tape unit 1, tape unit 2, etc. 


« address» is an even number from 2 to 28, inclusive. This specifies the GPIB 
address assigned to the tape unit in all GPIB communications. 


The default [4051 | 4923] setting is 4051; if this parameter is not specified, 4051- 


compatible format is assumed. The TA1 parameter may be abbreviated to T, but TA2, TA3, 
and TA4 may not be abbreviated. 
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A separate SET command must be given Юг each tape unit powered ир and attached to 
the 4027. 


Examples 
ІЗЕТ TA1 8 4051« CR» Instructs the 4027 that tape unit 1 is present 
ISET T 8<CR> at GPIB address 8, and instructs the 4027 to 
write data on tape unit 1 in 4051-compatible 
format. The GPIB address for a tape unit 
must be even. (Requires Option 4) 
ІЗЕТ ТА? 10 4923< CR» Instructs the 4027 that tape unit 2 is present 


at GPIB address 10, and instructs the 4027 
to write data on this tape unit in 4923- 
compatible format. (Requires Option 4) 


Plotter Parameters (Requires Option 4) 


To prepare the 4027 to communicate with a 4662 Interactive Digital Plotter (hereafter 
referred to as the plotter), two parameters must be set. 


e Since the 4027 may have two plotters attached to it, each plotter present must be 
numbered: plotter 1 or plotter 2. 


Ф Since the plotter is a GPIB device, it must be assigned a GPIB address. This 
address must be set physically by switches on the plotter; in addition, the 4027 
must be instructed to send information to the proper GPIB address. The plotter 
GPIB address may be any integer from 1 to 30 inclusive. It must not, however, be a 
tape unit address plus one, since this would duplicate the tape unit's command 
address. (See SETting the Tape Unit Parameters earlier in this section.) 


The command which initializes the 4027 to communicate with a plotter has the following 
format: 


ISET «device» «address» «CR» 


where: 


« device» is PL1 (for plotter 1) or PL2 (for plotter 2). 


« address» is an integer from 1 to 30, inclusive; this integer specifies the GPIB 
address of the plotter. 
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If two plotters are present, a separate SET command for each plotter is required. || 


МОТЕ || 


И switch settings on ће back of ће plotter are changed while the plotter is 


powered on, these switches are not read by the plotter until power is | | 
cycled. If you change the plotter’s address switches, go through the entire ы 

GPIB power up procedure. (See 4027 Operator’s Manual, the Peripheral 
Devices section.) | 
Ехатрје | | 
іші 
ІЗЕТ PL1 15<CR> Instructs the 4027 that plotter 1 is present | 
at GPIB address 15. This must agree with || 


the address switch settings on the plotter. 

GPIB addresses are specified for those, and 

only those, devices present and powered up Li 
on the GPIB. (Requires Option 4) 
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PERIPHERALS Command 


The PERIPHERALS command allows you to examine the 4027 settings for communicating 
with peripheral devices. 


Syntax 
{PERipherals [«device»]« CR» 


where «device» specifies a non-GPIB device on which the 4027 peripheral settings are 
to be listed. If «device» is not specified, it defaults to M (monitor). 


Action 


This command causes the 4027 to generate a peripherals data list. For each device 
attached to the terminal and powered up, this list gives the «device» parameter 
(explained in the SET discussion), the GPIB address (this field is blank for the printer), 
and a data field listing the parameter settings for that device (explained in the SET 
command discussion). 


The last line in the peripherals data list gives the EOF (end-of-file) string. (Setting the 
end-of-file string with the EOF command is discussed in System Status and Initialization.) 


Example 


IPER M«CR» Outputs a peripherals data list to the 4027 monitor. 
IPER« CR» 


A sample peripherals data list is shown in Figure 11-1. 


TAPE UNIT 1 RECORD DATA IN 4051 
MNEMONIC GPIB ADDRESS COMPATIBLE FORMAT 


TAL ве 4851 


PRINTER NO GPIB SEND LINEFEEDS 
ТА! 02 4051 MNEMONIC ADDRESS TO PRINTER PRINTER DELAY = 0 


г 
РЕ Й. PR А 5 од 


EO иж 


ЕОР NO GPIB 
MNEMONIC ADDRESS EOF STRING 


2402-19 


Figure 11-1. Peripherals Data List. 
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REPORT COMMAND | | 
| - 
| 
Тһе REPORT Command and Peripherals | 
Тһе REPORT command has the following syntax: | i 
! 
ы 
IREPort «device» «CR» 
The Host Programming for the 4027 section discusses the REPORT command and the | 
format of the ANSwer sent to the host for device 00 (System Status Block), and device 01 
(workspace cursor), device 02 (graphic beam information), and device 03 (crosshair | | 
information). Тһе 4027 can also report the status of each peripheral device and whether ы 
ог not the given peripheral is present (attached to the 4027 and powered ир оп the GPIB). 
This allows an applications program to investigate which peripherals are present ata | 
given time and branch or modify instructions accordingly. 
The peripherals have the following «device» numbers assigned: || 
<device> Peripheral(s) ' 
L 
04-07 Tape Units 1-4, respectively 
12,13 Plotters 1,2, respectively 7 
14 Printer “и id 
Tape Unit || 
When the command: 
i 
( 
IREPort n<CR> $ 
is given, апа п is chosen from 04-07 (representing tape units 1-4, respectively), the } | 
status of the designated tape unit is reported to the computer. This report has the ы 
following format: 
| ! 
‚+ 
IANS n,<p1>,<p2>,<p3>; ~ 


where: | 


<р1> = 1 if the tape unit is present; O, if not. 


<p2> is a two-digit decimal value indicating the last tape error code. (See Table 
11-1.) 


<p3> (4 bytes) = 4051 ог 4923, indicating the format in which information is to be j 
written on the tape. 7 
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Tabie 11-1 


TAPE ERROR CODES 


Code Meaning 
01 Domain error ог invalid argument 
02 File not found 
03 Mag tape format error 
04 Illegal access 
05 File not open 
06 Read error 
07 No cartridge inserted 
08 Over-read 
09 Write-protected 
10 Read-after-write error 
11 End of medium 
12 End of file 


Plotter 
When the command: 
{REP 12<CR> 


is given, the status of plotter 1 is reported to the computer. This report has the following 
format: 


IANS 12,<p1>,<p2>; 
where: 

«pi» = 1 if the plotter is present; 0, if not. 

<p2> (6 digits) is the value or each bit of plotter status word 0. 
The command: 


{REP 13<CR> 


causes a similar report for plotter 2 to be sent to the computer. 
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Printer | 


When the command: 


{REP 14<CR> 
4 
is given, the status of the printer is reported to the computer. This report has the following | 
format: 
i 
IANS 14,<p1>,<p2>,<p3>; 
where: \ | 
I 
«pi» = 1 if the printer is present; O, if not. 
«p2» = L if the line feed option is used, Е if the form feed option is used. (See the | 
Printer Parameters discussion in this section.) 
{ 
<p3> (3 digits) is the ASCII integer value of the printer delay. (See the Printer L 


Parameters discussion in this section.) 


МЛ 


11-10 @ 4027 PROGRAMMER’S 


Lp 


-一 


+ 


PERIPHERALS 
ALLOCATE COMMAND 


2 


ж 


COMMUNICATING WITH PERIPHERALS 


та са 


The remainder of this section discusses commands which enable the 4027 to 
communicate with peripheral devices. The ALLOCATE, DIRECTORY, and KILL commands 
are used to communicate with a tape unit; the PASS command is used to communicate 
with a plotter; and the COPY command is used to copy files from one device to another. 


一 一 


ALLOCATE Соттапа (Requires Option 4 апа а 4924 Tape Unit) 
Before information can be recorded on atape in 4051-compatible format, files must be 


created оп the tape to hold the information. This is done by using the ALLOCATE 
command. 


Syntax 
!ALLocate «device» «beg file> «number» «size» « CR» 


where: 


) 


« device» is a device mnemonic (T[A1], TA2, ТАЗ, or TA4) which specifies the tape 
unit used to record information. 


« beg file» is a non-negative integer which specifies the number of the first file to 
be created. 


« number» is a positive integer which specifies the number of files to be created. 
« size» is a positive integer which specifies the number of eight-bit bytes which 
each newly created file is to contain. Each tape cartridge can store approximately 
250K bytes of information. 


Action 


This command creates new files on a tape inserted in the tape unit specified by the 
« device» parameter. 


ЕР o. ъъ IL... ша ша 
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ь | 
« beg Ніе>-0. If the tape has not previously been used to record information, <beg _/ 
file> must Бе set to zero. This causes the tape to be properly initialized before a file 

structure is recorded on it. If the tape has already been used to record information, setting 

с Беа file> to 0 destroys а! information previously recorded on the tape, including the 

file structure marked on the tape; then the tape is reinitialized. In either of these cases, 

new files 1 through <number> are created. Each new file contains enough space to 

store <size> eight-bit bytes of information. 


Е 


C 


« beg file> positive. If «beg file> is positive, this command creates «number» 
consecutive new files on the tape. The first new file created is file number «beg file> and 
each new file contains enough space to hold «size» eight-bit bytes of information. 


С. T алач 


Examples 
INITIALIZING AN UNMARKED TAPE | | 


IALL ТА1 0,2,5000<СВ> 
IALL T 0,2,5000<CR> 


Initializes the unmarked tape in tape unit 1 
and creates two files (files 1 and 2) of 5000 Li 
bytes each. (If the tape has already been 

marked, this command destroys all old infor- б 


mation on the tape.) «У; М 


ALLOCATING FILE SPACE ON А MARKED ТАРЕ | 


IALL ТА1 1,2,5000< CR» 
IALL T 1,2,5000< CR» 


IALL TA1 7,4,8000« CR» 


11-12 


Creates two new files on tape unit 1, begin- 
ning with file 1. Each new file contains 5000 
bytes. 


Creates four new files on tape unit 1, 
beginning with file 7. Each new file contains 
8000 bytes. 
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In addition to the <number> new files created, ап ALLOCATE command attaches а file 
called LAST immediately after the last newly created file. The LAST file is always 768 
bytes long. It marks the logical end of the file structure on the tape. If new files are 
allocated in the middle of an existing file structure, all the old information on the tape from 
file <beg file> to the end of the tape is lost, even if the newly ALLOCATEd space is 
shorter than previously ALLOCATEd space. Suppose you have 10 files of 5000 bytes 
each on the tape in tape unit 1: 


= ЕЦЕ 1 FILE 2 ЕКЕ 3 FILE 4 FILE 5 | FILE 6 FILE 7 FILES | FILE 9 | FILE 10」 LAST 


The command 


IALL ТА1 4,3,5000 < CR» 


creates new files 4,5, and 6 (destroying the old files 4, 5, and 6) and attaches а LAST Не 


immediately following file 6: 
я ee er ee 
HEADER] FILE 1 FILE 2 FILE 3 FILE 4 FILE 5 FILE 6 | LAST]7 | FILES | FILES ! FILE101 LAST І 
(OLD) | (OLD) | (OLD) | (OLD) | (New) | (NEW) | (NEW) [(NEW)p) 1 (OLD) T (ош) | (OLD) | (OLD) I 
Ј – — 一 -- -- 一 一 = 


OLD FILES SAVED NEW FILES CREATED OLD INFORMATION 
NO LONGER ACCESSIBLE 


2 


The tape now contains six files. Even though old files 8-10 апа part of old Не 7 are still 
magnetically recorded on the tape, this information is no longer accessible. 
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DIRECTORY Command (Requires Option 4) 
When information has been stored on a tape, it will be necessary at times to examine the 
file structure on the tape (perhaps to recall how many files have already been created). 
The DIRECTORY command allows you to do this. 
Syntax 

IDIRectory «tape device» [« output device» ]« CR» 
where: 


«tape device» specifies a tape unit. 


« output device» specifies a non-GPIB device. If this parameter is not specified, it 
defaults to M (monitor). 


с po C C C D dq 【一 


Action 


This command outputs file header information stored on the tape in the tape unit 
specified by «tape device». The information on this tape must be recorded in 4051- 
compatible format. (Files recorded in 4923-compatible format do not contain file header 
information.) This information is recorded on the device specified by the «output 
device» parameter. This output device must be a non-GPIB device. Each file header lists 
the file number, the file type, and the length of the file. 


С 


C C єс C C C DL сс г 


There are three types of files: а NEW file is опе which has been marked on the tape, but 
no information has yet been recorded in it; a file with information recorded in it is an 
ASCII DATA file; the LAST file marks the logical end of the tape file structure. 


Even though file lengths аге ALLOCATEd in terms of bytes, the DIRECTORY command 
lists file lengths in blocks. In 4051-compatible format, a block consists of 256 bytes. 
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Examples 


The command 


IALL ТАТ 0,5,5000<CR> 


initializes the tape and creates five files of 5000 bytes each, as well as a sixth file, LAST. 
Suppose data is entered in files 1, 2 and 3, and one of the following commands is given: 


IDIR ТАЛ М<СН> 
ог 
IDIR Tx CR» 


The following list is displayed in the monitor: 


Note that a LAST file is always three blocks (768 bytes) long. 


The command: 
IDIR TA2P «CR» 


prints tape unit 2 file headers on the printer. 
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KILL Command 
When a (4051-compatible) file is first created, its file header reads NEW, meaning that the 
file exists but no information is recorded in it (except the file header information). When 


information is stored in that file, its file header is changed to ASCII DATA. 


An ASCII DATA file can be restored to its NEW status by the KILL command. 


Syntax 


IKILI «tape unit.file number» «CR» 


Example 


If you wish to restore file 6 on the tape in tape unit 1 to its NEW status, give the command: 


IKIL ТА1.6< CR» 


This restores the file header for that file to NEW and any information stored in the file is 
lost. 


C 


C 


11-16 @ 4027 PROGRAMMER'S 


2 


2 


2 


一 ool 


PERIPHERALS 
PASS COMMAND 


PASS Command (Requires Option 4) 


The 4027 can display graphs and text on a Tektronix 4662 Interactive Digital Plotter. The 
4027 has a vocabulary of commands for creating graphic displays. (See the Graphics 
section.) The plotter also has a vocabulary of commands for creating graphic displays. 
This plotter language includes more graphic capabilities than the 4027 language, and the 
formats of the two languages are different. Table 11-2 gives a summary of the plotter- 
command language. 


Ultimately, any command to which the plotter responds must be in plotter command 
language. The 4027 is designed so that the user can specify graphic commands destined 
for the plotter in either of two ways. 


1. Create a file of plotter-language commands and send that file to the plotter via the 
4027. 


This method has the advantage of using the full range of plotter commands; 
however, it has two disadvantages. First, such a command file can be used only 
for drawing graphs on the plotter. Since the 4027 does not understand plotter- 
language commands, this file is meaningless to it. Second (and more serious), the 
plotter language uses the ASCII<ETX> (end-of-text) character. Being a control 
character, it will not be displayed or inserted in the 4027 workspace unless the 
4027 is in snoopy mode. The <ETX> character is also used frequently in 
communications with the host computer. Transmitting a plotter-language com- 
mand file containing <ETX>s to or from some computers may cause unintended 
results. 


2. Create a command file of 4027 graphic commands and send that file to the plotter, 
instructing the 4027 to translate these 4027 commands into plotter commands. 


This method has the advantage that the command file thus created can be used to 
display the same graph both in the 4027 workspace and on the plotter. Such a file 
is easily transmitted to and from the computer with no troublesome control 
characters. 


This method has a disadvantage, however. Since the plotter's vocabulary of 
graphic commands is larger and more versatile than that of the 4027, a command 
file using only 4027 commands cannot use the full range of the plotter's graphic 
capabilities. 


To send 4027-style command files to the plotter, use the COPY command with the /P 
switch setting. (See the COPY discussion later in this section.) To send plotter-style 
commands which have no 4027 equivalents, use the PASS command. 
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The PASS command allows you to transmit plotter style commands to the plotter, without 
the 4027 trying to interpret them as 4027 commands and translating them. 
Syntax 

IPASs <string> «CR» 
where «string» can be: 

€ A delimited ASCII string. 

е One or more ADE values. 

e A combination of the above. 
Table 11-2 gives a summary of the plotter command vocabulary. Table 11-3 illustrates 
how various plotter commands are transmitted using the PASS command. 

Table 11-2 


PLOTTER LANGUAGE COMMANDS 


Command Action 
H«CR» Home. Moves the pen to the upper left 
ог corner of the plotting area. 
H«ETX»8 
M 50,75 «CR» Move. Moves the pen to the point (50,75) 
Or in the plotter system of coordinates». 


M50,75 <ЕТХ > 


D 100,50<CR> Draw. Draws а line from the current pen 
or position to the point (100,50) in the plotter's 
0100,50 < ЕТХ > system of coordinates. 
О 100,50 0,0 50,10<Cr> Draws a line from the current pen position to 
or the point (100,50); from there, to the point 
D100,50,0,0,50,10<ETX> (0,0); and from there, to (50,10). 
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Table 11-2 (Cont.) 


PLOTTER LANGUAGE COMMANDS 


Command 


Action 


PThis is a test.<ETX> 


Print. Prints on the plotter, starting at the 
current pen position, the message "This is a 
test.” 


$ 1.5,3.0<CR> 
or 
51.5,3.0<ЕТХ> 


Alpha Scale. Sets the size of each сһагас- 
ter cell to 1.5 graphic display units in the X- 
direction and 3.0 graphic display units in the 
Y-direction. (The “graphic display unit” is a 
measure of length used by the plotter. In the 
X-direction, it is 1/150 the length of the 
plotting area; in the Y-direction, it is 1/100 
the height of the plotting area.) 


ри ee AD 
В 10«CR» Alpha Rotate. Sets the angle at which 
or alphanumeric characters are printed on the 
R10<ETX> plotting surface. Characters printed after 
this command is executed slant upwards at 
ten degrees with respect to the positive X- 
axis. 
Е 2«CR» Alpha Font. Selects printing font number 2 
or from among the plotter’s seven fonts. 
F2<ETX> 
A<CR> Alpha Reset. Resets the alphanumeric 
or printing parameters (Alpha Scale, Alpha Ro- 
A<ETX> tate, Alpha Font) to their default values. 
Т O«CR» Prompt Light. Turns off the PROMPT light 
or on the plotter’s front panel. 
TO<ETX> 
T 1«CR» Turns on the plotter's PROMPT light. 
or 
T1«ETX» 


ато send an <ЕТХ> or « CR» in a PASS command, it must be put in as an ADE value, since control 


characters are not allowed in delimited strings. 


bThe plotter's coordinate system is not the same as the 4027's coordinate system. The plotter's X-axis 
always runs from O to 150, and its Y-axis runs from O to 100. 
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Table 11-3 


TRANSMITTING PLOTTER COMMANDS USING PASS 


Command 
Name Plotter Language 4027 Language 
HOME H«CR» IPASS "H",13« CR» 
H«ETX» IPASS"H",3« CR» 
MOVE М 50,75 «CR» IPASS "M 50,75" 13 « CR» 
M50,75 «ETX» ІРА55 "M50,75" ,3« CR» 
DRAW 0100,50<ЕТХ> IPASS "D100,50", 3 « CR» 
0100,50,0,0<ЕТХ> IPASS “0100,50,0,0”,3<СН> 
МОУЕ, 
followed ІРА55 “М50,75” “0100,100”,3 
Бу ОВАМ/а М50,75 0100,100<ЕТХ> МЕС 213,30,427,479<CR> 
PRINTb PThis is a test.< ETX > ІРА55“РТһі5 is a test." , 3« CR» 
ISTRING “This is a test.” < CR» 
ALPHA SCALE 51.5,3.0<ЕТХ> ІРА55 “51.5,3.0”,3<СНВ> 


+ 


ALPHA ROTATE | R10<ETX> IPASS "R10" ,3 «CR» 
ALPHA FONT F2«ETX» IPASS "F2", 3c CR» 
ALPHA RESET A«ETX» IPASS "А", 3< CR» 
PROMPT LIGHT | ТО<ЕТХ> IPASS "TO", 3 «CR» 
T! «ETX» IPASS "T1", 3« CR» 


атће coordinates іп the 4027-language VECTOR command differ from those in the plotter-language MOVE 
and DRAW commands. In translating VECTOR commands, the 4027 assumes a graphics area with a 
maximum X-coordinate of 639 and maximum Y-coordinate of 479 is to be mapped onto a plotter work area 
with maximum X-coordinate of 150 and maximum Y-coordinate of 100. 


Боту PRINT requires the СЕТХ > character. АП other commands take <ЕТХ> ог <CR> 
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COPY Command (Requires Option 3 or 4) 
The 4027 can transfer files of information from one device to another by means of the 
COPY command. 
Syntax 


ICOPY <source>[<switches>][<destination>][<switches>]<CR> 


Action 
This command copies the information contained in <source> to <destination>. If the 
<switches> parameter is present, the 4027 receives or transmits information according 


to certain conventions determined by the value of <switches>. The <source> and 
<destination> parameters are shown in Table 11-4. 


Table 11-4 


4027 COPY PARAMETERS 


Mnemonic 
Used As Used As Used As 
Device Parameter <source> <destination > 

4027 Workspace W or WO X X 
4027 Monitor M or MO X X 
Host Computer H or HO X X 
Printer P or PR X 
4662 Plotter 1 and 2 PL1, PL2 X X 
A file on a given tape unit TAn.k Х Х 


A particular file оп a tape is designated TAn.k (see Table 1 1-4). п this notation, nis the 
number of a tape unit (1<n<4) and k is the number of a file on the given tape unit (e.g., 
TA1.3 or TA3.15). The TA1 mnemonic can be shortened to T; for example, TA1.3 can be 
written T.3. 
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If <destination> is not specified, it defaults to W (Workspace). 


Examples 

ІСОР W H<CR> Copies the contents of the workspace to the 
host and includes an EOF at the end of the 
communication. 

ІСОР W TA1.3« CR» Copies the workspace contents to file 3 of 

{COP W T.3«CR» tape unit 1. 

ICOP ТАЗ.5 W<CR> Copies file 5 of the tape in tape unit 3 to the 

ICOP ТАЗ.5 < СЕ > workspace. 

{COP TA3.5 P<CR> Copies file 5 of tape unit 3 to the printer. 

ICOP TA2.15 PL1<CR> Copies file 15 of tape unit 2 to plotter 1. 


NOTE 


The COPY operation is non-destructive. The command !COP TA1.3 
W< CR» copies the contents of file 3, tape unit 1 to the workspace, 
leaving that information still stored in file 3 of tape unit 1. 


The «switches parameter consists of one or more slashes (/), each followed by a single 
letter. Each letter serves as a “switch” which, if present, instructs the 4027 to receive or 
transmit information in a certain way. Each switch is given for a specific purpose and is, 
strictly or loosely, associated with a specific «source» or «destination». The switches 
and their uses are summarized in Table 11-5: 


Table 11-5 


4027 COPY SWITCHES 


Switch Use 


/N When «source» is the workspace, this switch instructs the 4027 to 
ignore all attribute codes stored in the workspace display list and convert 
all ruling characters to asterisks. In this way, a form containing ruling 


characters can be copied to the printer. 
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Table 11-5 (Cont.) 


4027 COPY SWITCHES 


Use 


When <destination> is the workspace, this switch instructs the 4027 to 
treat all information coming from <source>, including the command 
character, as text to be displayed. This allows the 4027 operator to display 
a file containing commands in the workspace for examination and 
modification. Setting this switch is equivalent to pressing COMMAND 
LOCKOUT while the 4027 receives text from the host computer. Once the 
file is displayed in the workspace, however, the 4027 again recognizes the 
command character. To send such a file from the workspace to some other 
<destination> one can do either of two things: 


1. Initiate a file transfer from the workspace (COPY or, if «destination» 
is the host computer, SEND). 


2. Ifthe host is going to echo the data back, simply change the 
command character to a symbol which does not appear in the 
displayed file. Then COPY or SEND as usual. 


When <source> is the workspace and the workspace holds a form, this 
switch instructs the 4027 to copy data in the unprotected fields only. Ка 
form is being filled out repeatedly and you wish to store just the data in the 
form, use this switch. If the workspace holds a form and this switch is not 
set, a COPY operation copies the entire form, including attribute codes and 
data in protected fields. 


If the workspace does not contain a form (no attribute codes inserted in 
the display list), the /U switch has no effect. 


When «source» is the host computer and «destination is neither 
workspace nor monitor, this switch instructs the 4027 to display the 
copied file in the workspace. Without this switch set, a file copied from the 
host to file TA1.3, for example, would not be displayed on the screen. /D is 
legal only if «source» is the host. 


| 
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When а Не containing 4027 graphic commands is copied with the /Р 
switch set, the 4027 translates all VECTOR, RVECTOR, STRING, and PASS 
commands into plotter-command language. Only the boundary of a panel 
created with the POLYGON ог RPOLYGON command is drawn оп the 
plotter. This enables the same file to be used to create graphs on both the 
4027 and the plotter. /P is legal only if <source> is host or tape. 
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Exampies | 
ІСОР W/N P<CR> Copies the workspace contents to the prin- 
ter, ignoring attribute codes and converting Џ 
all ruling characters to asterisks. (Requires 
Option 3) 
ІСОР W/U TA1.4<CR> If the workspace holds a form, copies data U 
from the unprotected fields only to file 4 of 
tape unit 1. (Requires Option 4) | 
ІСОР НО TA2.5 «CR» Copies the host file to Не 5 of tape unit 2, 
displaying this file in the workspace as it is | 
copied. (Requires Option 4) 
ІСОР ТА1.7/Р РІЇ Copies Ше 7 of tape unit 1 to the plotter, |! 


translating а! VECTOR, ВУЕСТОВ, STRING, 
and PASS commands into plotter-command 
language. (Requires Option 4) 


С 
с... C сена 


К is possible to set more than one switch in а COPY command. Тһе command 
ІСОР H/D/P PL1<CR> 


copies the host file to plotter 1, displaying this file in the workspace and translating 4027 
graphic commands into plotter-command language. 
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Auto-Incrementing the Tape Unit 


When a particular file on a tape unit is designated in a COPY command, the 4027 
remembers that file number until it is replaced by another file number (or until the 4027 is 
RESET or powered off). If the file number is omitted in a subsequent COPY command, the 
4027 automatically increments the file number in its memory by one and copies to or from 
that file on the tape. 


This feature is useful in text editing or form fillout. Suppose the operator has created a 
form in the workspace and stored the form on tape unit 1 with the command 


ICOP W TA1.1« CR» 
Suppose the PT (Pad Terminator) key has been programmed to give the command 
ICOP М/О TA1!ERA М «CR» 


The operator fills out the form and presses PT. The 4027 stores the data from the 
unprotected fields in the next available file (file 2) of tape unit 1 and erases the 
workspace. (With the 4027 in form fillout mode, only the data in the unprotected fields is 
erased.) The operator fills out the form again, with different data, and again presses PT. 
Again the 4027 stores the data from the unprotected fields in the next available file (now 
file 3) of tape unit 1 and erases the blanks of the form. The operator proceeds in this way 
as long as necessary. 


As another example, suppose successive pages of text to be edited are stored in files 12- 
27 of tape unit 2. To get the first page into the workspace, give the command 


ІСОР TA2.12« CR» 


To get each succeeding page, give the command 


ICOP TA2« CR» 


Copying the Workspace to the Plotter 


If the workspace holds a graph, it is tempting to try copying this graph directly to the 
plotter. This cannot be done. The workspace display list does not contain sufficient 
information to translate the graphic information displayed into commands which can 
recreate the graph. If the 4027 is commanded to copy the workspace to the plotter, 
graphic information does not copy. (This is similar to the SEND command.) To obtain 
graphs, you must store somewhere (on a tape or in the host) a command file containing 
the necessary commands to recreate the graph. These cannot be derived from the display 
list. 
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COPYING ON A HARD COPY UNIT 


Н the 4027 contains Option 42 (Hard Copy and Video Out), a Tektronix 4632 Video Hard 
Copy Unit (Option 6, Enhanced Gray Scale required) can be used to make copies of the 
workspace, the monitor, or the screen. 


This 4632 Video Hard Copy Unit produces pages of copy approximately 8-1/2 inches by 
11 inches in size. These copies can show whatever can be displayed on the screen: 

text, control characters in snoopy mode, rulings, alternate character fonts, visual 
attributes (except blinking), and graphs. One or several 34-line "pages" from the 
workspace or the monitor can be copied. The 4632 produces gray-scale reproductions of 
the displayed copy aligned with the short axis of the 4027's display. 


Hard copies are made on the 4632 Video Hard Copy Unit with the HCOPY command. 


HCOPY (Hard Copy) Command (Requires Option 42) 


Syntax 
ІНСОру [< count» ][Workspace | Monitor | Screen] < CR» 


where «count» is a positive integer. If « count» is not specified, it defaults to one. 


Action 


ИМ (monitor) ог W (workspace) is specified, this command copies «count» "pages" 
from the specified scroll to a Tektronix 4632 Video Hard Copy Unit. The copy begins with 
the first visible line in that scroll. Each "page" of copy continues until it includes 34 lines 
of text or until an ASCII «FF» character appears in column 1 of a line. The line of text 
containing such a form feed is not copied. If the specified scroll contains fewer than 

« count» pages, only the number of pages in the scroll is copied. If one attempts to make 
a hard copy of a blank scroll, one (blank) page of hard copy will be produced. 


If S (screen) is specified, «count» is ignored and one copy of the visual screen display, 
both workspace and monitor windows, is made. 


If the HCOPY command comes from the computer and neither W nor M nor S is specified, 
pages are copied from whichever scroll receives text from the computer. 


If the HCOPY command is typed on the keyboard and neither W nor M nor S is specified, 
pages are copied from whichever scroll receives text from the keyboard. 
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Examples 


НСО 3 W«CR» 


НСО M<CR> 


5 


НСО S<CR> 


ІНСО<СН> 


дано | 


2 
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PERIPHERALS 
HCOPY COMMAND 


Copies three "pages" from the workspace to 
the Hard Copy Unit. The first page copied 
begins with the first line visible in the 
workspace. 


NOTE 


This means one copy each of three consec- 
utive pages in the workspace scroll, not 
three copies of the same page. If the work- 
space contains only one page, then only one 
sheet of copy is produced. 


Copies one page from the monitor to the 
Hard Copy Unit. This page begins with the 
first line visible in the monitor. 


Copies all information displayed on the 
screen to the Hard Copy Unit. 


If this command comes from the computer, 
copies a page from the scroll which receives 
text from the computer. 


If this command is typed on the keyboard, 
copies a page from the scroll which receives 
text from the keyboard. 
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Appendix А 


ТЕКТВОМХ em уми 
о 4027 - 

COLOR „Ве 
STANDARD 


0° Blue 


340° 


HUE (H) О-3609 
LIGHTNESS (L) 0-100% 
SATURATION (S) 0-100% 


Example 1: 
IMAP C2 240 50 33 
(H) (L) (S) 


*Note: 
The lightness planes (L) shown on the scale are for 
S = 100%. If S = 0% the lightness planes will be: 
L = 71 - 100 (white) 
L = 43- 70 (light grey) 
L = 14- 42 (dark grey) 
L 0- 13 (black) 


э 


L=0 black 
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TEKTRONIX 
4027 
COLOR 
STANDARD 


Overview: 


The world of color is filled with ambiguous 
terminology, i.e. intensity, purity, value, etc. 
Many color users feel that “color theory” is a 
prerequisite to operating color systems; T.V., 
Videotaping, Photography, Computer Graph- 
ics. 


In order to end this confusion, Tektronix has 
developed a color language and function 
based on human engineering, rather than 
machine engineering. Below is a description 
of this system, which will provide a clear 
and concise means for understanding how 
color is defined and how our syntax was 
derived. 


4027 Color Concepts: 


Color selection is specified by hue, light- 
ness and saturation which is the HLS 
method. The definitions are as follows: 


Hue: The characteristic associ- 
ated with a color name 
such as red, yellow, green, 
blue, etc. Hue is a grada- 
tion of color advanced by 
degrees, thus represented 
as an angle from 0 to 360. 


The characteristic that al- 
lows the color to be 
ranked on a scale from 
dark to light. Lightness is 
expressed as a parameter 
ranging from 0 to 100% 
with black being O (bot- 
tom of cone) and white 
being 10096 (top of cone). 


Lightness: 


A-2 


The characteristic which 
describes the extent to 
which a color differs from 
a gray of the same light- 
ness. Saturation is ex- 
pressed as percentage, 
ranging from 096 (maxi- 
mum white content at that 
lightness level) to 100% 
(full saturated). 


Saturation: 


Geometrically, colors can be described in 
terms of a double cone (see Figure 1). 
Variations in lightness are represented 
along the axis, with white at the apex of 
the cone and black at the opposite apex. 
Variations in saturation are represented by 


radial distances from the lightness axis, in Q 


constant lightness planes. Hue is repre- 
sented as an angular quantity from a known 
reference point. 


The 64 colors available in the 4027 are 
discrete samples from this continuous color 
space. They are obtained by intersecting the 
cone into several planes of constant light- 
ness. 


Copyright © 1978 by Tektronix, Inc., Beaverton, Oregon. 
Printed in the United States of America. All rights 
reserved. Contents of this publication may not be 
reproduced in any form without permission of Tektronix, 


U.S. and foreign patents and/or patents pending. 


Inc. U.S.A. and foreign TEKTRONIX products covered o 


TEKTRONIX is a registered trademark for Tektronix, Inc. 
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A better understanding of the color standard can be had by looking at a cross section of 
the double-ended cone (Figure A-2). There are four gray levels along the middle of the 
cone. At 0% saturation the four levels of gray are black, dark gray, light gray, and white. At 
any other value of saturation, different hues (color mixtures) are obtained. Hue has no 
effect at 0% saturation. А maximum of seven different "planes" of color can be obtained at 
any value of saturation except 0%. 


LIGHT GRAY 


0% SATURATION 


50% SATURATION 


„т 100% SATURATION 


DARK GRAY 


0% 
LIGHTNESS рыр 
0% 
SATURATION 


Figure A-2. Cross Section of the 4027 Color Standard. 
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Аррепдіх В 


THE ASCII CODE 


Table B-1 


ASCII CODE CHART 


BITS 
B4 B3 B2 Bl CONTROL а ae LOW X LOW Y 


OLA APES 
побои иа 
ШЫЛ MAREA ARTE 
А 
0 


1 | ЕМ 
Q 21 ЗИ 53 69 85 101 117 


к, 


ЕНЕ 
| 


0 
a Maf Ја 
к” 
РЕНН 
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B-1 


ASCII CODE 


B-2 


Mnemonic 


02 ФО om OM ФО zM 20 рт «0 х2 БО ФО мо -O ГО -Oo 00 ФО ят 4€ 4C 4I о го x» от AM xm хо то c7 


ac 


Usual 
ASCII 
Abbrev. 


Table B-2 


ASCII CONTROL CHARACTERS 


Name of Character 


Null 

Start of Heading 
Start of Text 

End of Text 

End of Transmission 
Enquiry 
Acknowledgement 
Bell 

Backspace 
Horizontal Tab 

Line Feed 

Vertical Tab 

Form Feed 

Carriage Return 
Shift Out 

Shift In 

Data Link Escape 
Device Control 1 
Device Control 2 
Device Control 3 
Device Control 4 
Negative Acknowledgement 
Synchronization Character 
End of Transmission Block 
Cancel 

End of Medium 
Substitute 

Escape 

Field Separator 
Group Separator 
Record Separator 


Unit Separator 


Keys to Press 


CRTL- @ 
CTRL-A 
CTRL-B 
CRTL-C 
CTRL-D 
CTRL-E 
CTRL-F 
CTRL-G 
CTRL-H 
CTRL-I 
CTRL-J 
CTRL-K 
CTRL-L 
CTRL-M 
CTRL-N 
CTRL-O 
CTRL-P 
CTRL-Q 
CTRL-R 
CTRL-S 
CTRL-T 
CTRL-U 
CTRL-V 
CTRL-W 
CTRL-X 
CTRL-Y 
CTRL-Z 
CTRL-[ 
CTRL- \ 
CTRL-] 
CTRL-| 
CTRL- ^ 
(CTRL-up arrow or 
CTRL-circumflex 
accent) 
CTRL-— 
(CTRL-underscore) 
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Аррепдіх С 


е 4010-STYLE GRAPHICS CODES 


Table C-1 


4010-STYLE GRAPHICS CODE CHART 


Low Order X Low Order Y 


ASCII DEC. Х or Ү Coordinate DEC. ASCII 
@ 64 0 96 128 96 : 
А 65 1 33 97 129 161 193 225 97 а 
В 66 2 34 98 130 162 194 226 98 b 
C 67 3 99 с 
р 68 4 100 а 
Е 69 5 101 е 
Е 70 6 102 f 
G 71 7 103 g 
H 72 8 104 h 
| 73 9 105 | 
Ј 74 106 і 
[4 75 107 k 
В 76 108 | 
M 77 109 m 
N 78 110 n 
о 79 111 о 
Р 80 112 р 
о 81 113 а 
В 82 114 г 
5 83 115 $ 
T 84 116 t 
U 85 117 T 
V 86 118 v 
М 87 119 м 
х 88 120 х 
У 89 121 y 
2 90 122 z 
Г 91 123 ( 
\ 92 124 Я 
1 93 125 ) 
А 94 126 


пува 


| 


High Order X & Y 


INSTRUCTIONS: Find coordinate value in body of chart; follow that column to bottom of chart to find decimal value or 
ASCII character which represents the High Y or High X byte; go to the right in the row containing the coordinate value to 
find the Low Y byte, or go to the left to find the Low X byte. EXAMPLE: 200Y, 48X equals 38 104 33 80 in decimal code, 
and equals & h ! P in ASCII code. 
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4010 СВАРН!С$ 


А5С!! DEC. 


C-2 


> ига мехе <счозпот028г хе -тотпооогре 


Low Order Х 


Table C-1 (cont) 


4010-STYLE GRAPHICS CODE CHART 


X or Y Coordinate 


352 
353 
354 
355 
356 
357 
358 
359 


High Order X & Y 


384 
385 
386 
387 
388 
389 


Low Order Y 
DEC. ASCII 


100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 


~ -- ом ех 5 сс ни tn QA TO BSB З-хо- - зо HM An сто 


nlS8yr 
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Low Order Х 
ASCII DEC. 


> -пм < ж3в <с 4 опрзъо22гхле-толпоооеогргф-е 
ч 
о 
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Table С-1 (cont) 


4010—STYLE GRAPHICS CODE CHART 


X or Y Coordinate 


640 
513 545 577 609 641 673 705 737 
514 546 578 610 642 674 706 738 
515 547 579 611 643 675 707 739 
516 548 580 612 644 676 708 740 
517 649 581 613 645 677 709 741 
518 550 582 614 646 678 710 742 
519 551 583 615 647 679 711 743 
520 552 584 616 648 680 712 744 
521 553 585 617 649 681 713 745 
522 554 586 618 650 682 714 746 
523 555 587 619 651 683 715 747 
524 556 588 620 652 684 716 748 
525 557 589 621 653 685 717 749 
526 558 590 622 654 686 718 750 
655 


657 
658 


660 


52 


High Order X & Y 


4010 GRAPHICS 


DEC. 


100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 


Low Order Y 


-- ~ мю х3 < с ~» ~—соољ3—х>~— - зе ~Фао со 


) 
пува 


C-3 


4010 GRAPHICS 


Low Order Х 


ASCII DEC. 


>әə“ң<-ы<хк<саоошооогЕгхде--іоттооо>»6 


Table С-1 (cont) 


4010—STYLE GRAPHICS CODE CHART 


X or Y Coordinate 


864 
865 
866 
867 
868 
869 
870 
871 
872 
873 
874 
875 
876 
877 
878 
879 
880 
881 
882 


59 


High Order X & Y 


896 
897 
898 
899 
900 
901 
902 


Low Order Y 
DEC. ASCII 


96 i 
97 
98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 


112 
113 

114 

115 

116 

117 

118 

119 

120 

121 

122 

123 

124 

125 ) 
126 ~ 
127 па" 
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Џ 
b 
с 
TEE 
e 
f 
| Џ 
ћ 
i 
J 
қ Џ 
| 
т 
110 п ol 
111 о 
р 
| | 
г 
5 
t 
и 
у 
м 
ЖЕ 
У 
2 
| Џ 


Table D-1 


Appendix D 


4027 ALTERNATE CHARACTER FONTS 


ALTERNATE CHARACTER FONTS 
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ALTERNATE FONTS 


Table D-2 


RULING JUNCTIONS CHART 


Rulings 
(Font 1) 


Standard 
(Font 0) 


ФҮҮСҮҮЙҮҮҮҮҮВ 
CSc. iC | 
Х“11М11К111117 
b ^ JC | 
НҮҮОҮҮІҮҮҮҮҮЈ 
[ s t | 
Е =f | 
Dru [ 
РҮҮМҮҮОҮҮҮҮҮК 
DJICJIEIIIIIF 
TEM кре - 
XYYIYYOYYYYYZ 
eb > Bi 
(21К11М11121М 
= (а = 
= Е = = 
e E us - 
T331932U3321)V 


4))с))е)))))Е 
ФЕ ? ? 
xYYIYYoYYYYYz 
ег 2? ? 
1))к))т)))))п 
? [ ? ? 
гр? ? 
21 7? ? 
.))5))и)))))џ 


Һ222Е1211121) 
5 oa [ 


г> С 
")))ч)))0)))“ 
( = | 


[ 2-4 
р212122102216 


811111411112 
= ? = 


= ? = 
XYYYYYOYYYYYX 


4024/4025 
RULINGS 


4027 
RULINGS 
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SAMPLE PROGRAMS 


This appendix contains three sample programs for the 4027 Color Graphics Terminal. The 
first is a program written in BASIC which allows the operator to sample the 64 colors of 
the terminal. The second is a short program (actually a segment of a larger program) in 
PASCAL which processes the input to the host from a !ВЕР 00 command. The third is a 
complete COBOL program which displays a form in the terminal workspace and stores 
the data from the form in a file. 


THE BASIC PROGRAM 


The program which follows is written to demonstrate the 64 color mixtures available on 
the terminal. The program allows the operator to move the graphic cursor to any position 
on the center plane of the color cone. Any one position on this plane represents the 
<hue>, <lightness>, and <saturation> parameters of a MAP command. The second 
parameter, <lightness>, varies the color created by the other two parameters. The 
program displays all seven variations on the lightness plane with <hue> and 
<saturation> remaining constant. 


11- 20 

x= 168 

y=200 

r=100 

t=5 

!goto setup subroutin 

10 gosub 8000 

16 12=34 

17 13:48 

18 14=62 

19 15=74 

990 rem Enable cross-hair,turn off ink, and input a point 
998 print "!ena" 

999 print "!ink п" 

1000 print"!era m!rep 03" 

1005 input d1$,k1,x1,d2$ 

1006 on error goto 1000 

1007 y1zval(left(d2$,(1en(d2$)-1))) 

1009 if х1-0 then goto 9000 

1010 х2-х1-х 

1015 у2-у1-у 

1020 if x2=0 then х2-.001 

1022 rem If cross-hair is not in the circle then get another point 
1025 if sar((x2*x2)+(y2*y2))>r then goto 1000 
1030 h=fix(atn(y2/x2)/k) 

1031 if х2<0 then h=h+180 

1032 if h«0 then h=h+360 

1035 s=fix(sqr((x2*x2)+(y2*y2) )*100/r) 

1050 gosub 2000 

1055 goto 1000 


о ч сл + 
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SAMPLE PROGRAMS 


2000 !color output 
2005 print"!map cl 
2010 print"!map c2 
2015 print"!map c3 
2020 print"!map cH 
2025 print"!map c5 


routine 


2030 print"!wor h!jum 8 8" 


2032 print"Huez";h,"Saturationz";s 


2035 print"!mon h" 
2040 return 
8000 !seup routine 


8001 print"!map cO 0 0 O!map с7 0 50 O!map c6 0 100 O" 
8002 print"!wor 30!gra 1 30" 


8003 k=6.28/360 
8005 !draw circle 


8009 print "!col cO" 


8021 print "!vec ";x;y;"!cir "; ү 


8022 print "!cir "; 


r/2 


8023 print "!line 2" 


8024 for 4-15 to 345 step 30 
8025 print"!vec";fix(r/2*cos(i*k))«x;fix(r/2*sin(i*k))«y; 
fix(r*cos(i*k) )+x;fix(r*sin(i*k) )+y/1 


8026 next i 


8027 print "!line 1" 


8028 for і-10 to 350 step 20 


8030 print "!vec "; 


8035 print fix(r/2*cos(i*k))«x;fix(r/2*sin(i*k))«y; 
8040 print fix((r+t)*cos(i*k) )+x;fix((r+t) *sin(i*k) )+y 


8041 next i 


8042 for i=30 to 330 step 60 
8043 print"! vec"; x;y;fix(r*cos(i*k) )+x;fix(r*sin(i*k) )+y 


8044 next i 

8047 tl=y-r-75 
8048 t2=y-r-25 
8050 for i=0 to 6 


8055 print"!col e";chr$(i+48);" cO" 


8060 print"! pol ";336;51+1%50; 600; 2 1+1#50; 600; 6 2+1#50; 336; t2+i*50 


8065 next i 
8099 print"!wor h" 


8100 print"! jum 2 38;Lightness" 


8105 print"!jum 4 3 
8110 print"!jum 7 4 
8115 print"!jum 11 
8120 print"!jum 1H 
8125 print"!jum 18 
8130 print"!jum 21 
8135 print"! jum 25 
8140 print'"!jum 29 
8145 print"!mon h" 
8150 print"! jum" 
8999 return 

9000 print "!disa" 
9001 Stop 

9999 end 


9; 100" 
0; 83" 

40; 67" 
40; 55" 
цо; 41" 
40; 27" 
40; 13" 
41;0" 
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THE PASCAL PROGRAM 


The following PASCAL program issues a !REP 00; command to the terminal, analyzes the 
ANSwer to the host, and returns the terminal status indicated by ANSwer. (See the 
REPORT command discussion in the Host Programming for the 4027 section.) 


{$t-,d-} 
{*** REPORT %%% 


This will read the data returned from the terminal for the 
various REPort commands } 


VAR No more to до : boolean; 


PROCEDURE Convert number(VAR number:integer); 
{ This will convert the ASCII character string being input 
by the terminal to INTEGER format. Any non-numeric character 
terminates the conversion process. The default value is 0 } 


BEGIN 
number := 0; { set up default value } 
WHILE tty^ in ['0'..'9'] DO BEGIN 
number := number*10 + (ord(tty^)-58); 
get(tty) 


END; {of while} 
END; { converting a number } 


PROCEDURE Report_1; 
{ This will inquire about the system itself } 


VAR Blocks 
‚ Bytes 
а 
„Status 
integer; 
BEGIN 
Write (tty,'!rep 00;'); { Issue report request } 
Break; Reset(tty); 
WHILE tty^ # '!' DO get(tty); { Search for command character } 
FOR i := 1 to 6 DO get(tty); { Skip over to the type of ans } 
IF tty^ # '0' THEN Writeln (tty,'<< ANS not of proper type >>") 
ELSE BEGIN 
get(tty); get(tty); { skip commas } 
convert number (blocks) ; { get blocks free } 
write (tty,blocks:4, '=Blocks/'); 
bytes := blocks*16; { convert blocks to bytes } 
write (tty ,bytes:5,'=Bytes Available'); 
get(tty); { skip comma ) 


convert number(status); 
CASE status OF 


1 Write (tty,' < Buffered 5"); 
г: Write (tty," < Form Fill out 2"); 
3 : Write (tty,' < Buffered & Form Fill out >"); 
4 : Write (tty,' < Monitor Present >"); 
5 : Write (tty,' < Buffered & Monitor Present >'); 
6 : Write (tty,' < Form Fill out & Monitor Present >"); 
7 Write (tty,' < Monitor, Form, & Buffered 5") 
END; { “a CASE } 
END {If then ELSE} 
END; {report 1} 
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{ * 关 жж MAIN кж ok ox ) 
BEGIN 


Rewrite (ttyoutput); ( Open tty communications ] 
No more to do :- true; ( initz ) 


КЕРЕАТ 

Report 1; 

по more to до := true 
UNTIL no more to до 


END. 


THE COBOL PROGRAM 


The program which follows is written in COBOL and demonstrates the use of form fillout 
and buffering. The program could have been written in any language which supports 
some way of writing to and reading from the display character type information. 


Design Objectives 


Because COBOL works best with defined fields of fixed length and because the 1968 
COBOL standard has no string handling verbs, this program was set up to process a field 
at a time instead of a line at a time. 


To make the 4027 do this, buffered mode is used and the FIELD SEPARATOR character is 
Set to carriage return. The EOL string becomes the field separator in addition to 

the normal end-of-line string. In this manner, the ACCEPT always gets either one field 
followed by an EOL or just an EOL. With SEND MOD, each field of variable form data is 
preceded by seven characters of row and column information. The amount of form data is 
variable because trailing blanks are not sent. 


This field is ACCEPTED into TERMINAL-DATA which is PICTURed large enough to 
contain the largest data field from the form plus seven more characters. 


Analyzing the Input 


The program examines TD-ROW. Once the row is identified, a routine is PERFORMED to 
examine TD-COLUMN. Once the column is identified, a routine is PERFORMED to analyze 
the data. In this program the data analysis simply stores the data in a file. Because data is 
being moved from a larger to smaller field, the compiler will generate warning messages 

telling you of this fact. O 
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End of Data From the Terminal 


SAMPLE PROGRAMS 


Since this form does not require all of its fields to be entered and since the information is 
received and processed a field at a time, line 23 was set up as a protected modified field. 
Therefore, this field is always sent to the host and is sent last. When this field is received, 
the end of the screen has been reached and everything on that screen has been 
processed. An appropriate indicator is set to indicate the end of the buffer. 


Exiting the Program 


To provide an orderly exit from the program, the keyword QUIT is entered into the first 
field of a new screen. The column processor for that line detects QUIT and sets an end of 
job indicator which signals the end to the rest of the program. An exit is made after the 
terminal is returned to a reference state for the next job. 


Synchronous Protocol 


This program was run using asynchronous protocol. If you use a synchronous protocol 
which transmits large amounts of data at once, the program or some routine in the system 
should be assigned the task of reading all the data and placing it into the proper places. 
In this case, the program looks different because the data is all present at once (ina 
manner similar to reading a file). 


000100 IDENTIFICATION DIVISION. 


000020 PROGRAM-ID. FORM. 


000300 REMARKS. 
000400* 
000500** 
000600** 
000700%% 


THIS IS А SAMPLE PROGRAM WHICH SENDS A FORM 
TO THE TERMINAL AND PROCESSES THE DATA RETURNED. 


000800%% << INPUT/OUTPUT ASSUMPTIONS >> 


000900 
001000%% 


THIS PROGRAM USES THE 


"ACCEPT! 


001100** COMMUNICATE WITH THE VIDEO TERMINAL. 
001200** IS AS PER USUAL. 


001300** 
001400** 


001600** FORMAT. 
001700** 
001800** 
001900** 
002000%% 
002100%% 
002200%% 
002300%% 
002400%% 
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AND 


'DISPLAY' VERBS ТО 


FILE OUTPUT 


THE INPUT FROM THE TERMINAL IS VARIABLE IN LENGTH WITH 
001500** THE FIRST 7 CHARACTERS ALWAYS PRESENT AND IN THE SAME 


FROM TERMINAL: 


———— e) 


ROW,COL...... 


...... 
~ 


! END OF DATA 
START OF DATA 
COLUMN DATA STARTS IN 
ROW DATA STARTS IN 


SAMPLE PROGRAMS Џ 
002500%% THIS PROGRAM WAS ORIGINALLY DEVELOPED ON А DECSYSTEM-10 9 
002600%% AND WITH MODIFICATIONS TO THE 'SELECT' AND "ЕР" STATEMENTS AND || 
002700%% CHANGING THE 'DISPLAY-7' TO WHATEVER DISPLAY ALLOWS INPUT OF 
002800** OF UPPER AND LOWER CASE CHARACTERS SHOULD CONVERT IT TO 
002900** ANOTHER SYSTEM. 

005200 ENVIRONMENT DIVISION. || 
005300 INPUT-OUTPUT SECTION. 
005400 FILE-CONTROL. 
005500 
005600 SELECT TEK-FORM | 
005700 ASSIGN ТО DSK 
005800 ACCESS MODE IS SEQUENTIAL 
005900 PROCESSING MODE IS SEQUENTIAL. 
006000 | 
006500 
006600 DATA DIVISION. 
006700 
006800 | 
006900 
007000 FILE SECTION. 
007200 
007300 FD TEK-FORM 
007400 VALUE OF ID IS "БАТА SEQ! 
007500 DATA RECORD IS TEK-FORM-DATA. 
007600 01 TEK-FORM-DATA USAGE IS DISPLAY-7: 
007700 02 TF-REF PIC X(10). 
007800 02 TF-CUST. 
007900 03 TF-CUST-1 PIC X(4). 
008000 03 TF-CUST-2 PIC X(10). 
008100 02 TF-INSTRUMENT PIC X(8). 
008200 02 TF-VALUE PIC X(8). 
008300 02 TF-TYPE PIC X(5). 
008400 02 TF-FC-AMOUNT PIC X(13). 
008500 02 TF-RATE PIC X(12). 
008600 02 TF-DOLLARS PIC X(15). | 
008700 02 ТЕ-ОЏВ-АССТ РІС X(4). 
008800 02 TF-CONTRACT-NR РІС Х(8). 
008900 02 TF-CREDIT-REFERENCE РІС Х(12). 
009000 02 ТЕ-СНЕСК-ОК РІС X(1). | 
011000 
011900 WORKING-STORAGE SECTION. 
012000 
012200 | 
012300 01 TEK-FORM-FILL-OUT USAGE IS DISPLAY-7. 
0121400%----------------------- 
012500 
012600 02 ТЕЕО-0 РІС X(33) VALUE IS || 
012700 '!КОВ N;!BUF;!WOR 24 К H;!JUM; ! ERA'. 
012800 02 TFFO-1 PIC X(12) VALUE IS 
012900 "!JUM;!ATT ТР". 
013000 | 
013100 02 TFFO-1A РІС Х(19) VALUE IS 
013200 "ЛОМ 1,117 C2 коз, 
013300 
013400 02 ТЕЕО-1В РІС X(33) VALUE IS 
013500 '!JUM 1,27;SAMPLE OF FORM FILL OUT’. 
013600 
013700 02 TFFO-1C PIC X(27) VALUE IS 
013800 '!JUM 1,79; !ATT PCO;!JUM 3,1", 
013900% 
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014000 02 ТЕЕО-3 РІС Х(19) VALUE IS 
014100 "ТАТТ P;REF !JUM 3,6". 
014200 
014300 02 ТЕЕО-ЗА РІС X(27) VALUE IS 
014400 "ТАТТ C2A; !JUM 3,16". 
014500 
014600 02 TFFO-3B PIC X(36) VALUE IS 
014700 '1ATT PCO; CUST !ATT С2А; !ATT PCO’. 
014800 
014900 02 TFFO-3C PIC X(27) VALUE IS 
015000 ' LATT C2A;!JUM 3,39; !ATT PCO’. 
015100 
015200 02 TFFO-3D PIC X(46) VALUE IS 
015300 ' INSTRUMENT ! ATT C24; !ATT PCO;!JUM 3,61". 
015400 
015500 02 TFFO-3E PIC X(33) VALUE IS 
015600 ' VALUE DT !АТТ C24; !ATT PCO'. 
015700 
015800* 
015900*LINE 5 
016100* 
016200 02 TFFO-5 PIC X(55) VALUE IS 
016300 '!JUM 5;!ATT PCO; TYPE "АТТ C24; !JUM 5,17;! 
016400 
016500 02 ТЕЕО-5А РТС X(45) VALUE IS 
016600 ' F/C AMT !JUM 5,27;!ATT AC2;!JUM 5,40; !ATT PCO’. 
016700 
016800 02 TFFO-5B PIC X(33) VALUE IS 
016900 ' RATE !ATT C2A;!JUM 5,60; !ATT РСО". 
017000 
017100 02 TFFO-5C PIC X(30) VALUE IS 
017200 ' $ !ATT C2N!JUM 5,79; !ATT PCO’. 
017300 
018000* 
018100* LINE 7 
018200* 
018400* 
018500 
018600 02 TFFO-7 PIC X(45) VALUE IS 
018700 '!JUM 7;!ATT PCO; OUR ACCT !ATT AC2; ТАТТ PCO'. 
018800 
018900 02 TFFO-7A РІС X(30) VALUE IS 
019000 " CONT# !ATT AC2; !ATT PCO'. 
019100 | 
019200 02 ТЕҒО-ТВ РІС X(46) VALUE IS 
019300 ' CREDIT REFERENCE# !ATT AC2;!JUM 7,62; !ATT PCO'. 
019400 
019500 02 TFFO-7C РІС Х(29) ҮАШЕ 15 
019600 ' СНЕСК ОК !АТТ АС2; !АТТ РСО'. 
019700 
030100* 
030200* LINE 23: SPECIAL END OF SCREEN DATA FLAG 
030300% 
030400 02 TFFO-EOD-FLAG РІС X(45) VALUE IS 
030500 '!JUM 23;!ATT РМ;01'. 
030600* 
030700* FORM END 
030800* 
030900 02 TFFO-END PIC X(13) VALUE IS 
031000 '!JUM 3,6;!FOR'. 
031100 
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ATT РСО". 
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SAMPLE PROGRAMS 

031200 01 TERMINAL-DATA USAGE IS DISPLAY-7. | 

031300%================ 

031400 

031500 02 TD-LOCATION. 

031600 03 TD-LOC-ROW РТС X(3). | 

031700 03 FILLER PIG X. 

031800 03 TD-LOC-COL РТС X(3). 

031900 02 TD-DATA PIC Х(40). 

032000 

032100 01 INDICATORS. 1 

032200%============== 

032300 

032400 02 END-OF -JOB-IND PIC X(3). 

032500 88 END-OF-JOB VALUE IS 'EOJ'. | 

032600 

032700 02 LINE-IS-EMPTY-IND РТС Х(3). 

032800 88 LINE-IS-EMPTY VALUE IS 'EOL'. 

032900 1 

033000 01 СОМ5ТАМТ5. 

033100#:-#в 2.3 << +<< 

033200 

033300 02 РКОМРТ-4025 РТС X VALUE IS "?", | 

033400 

033500 01 VARIABLES. 

033600%= =====ЕЕЕЕЕ = 

033700 | 

033800 02 TIMES-SCREEN-RESET РІС 9(2). 

034090“ 

034100 PROCEDURE DIVISION. 

034200% * U | 

034400 

034600 INITIALIZATION. 

034800 

034900 OPEN OUTPUT TEK-FORM. || 

035000 MOVE SPACES TO TEK-FORM-DATA. 

035100 PERFORM TERMINAL-SET-UP. 

035200 PERFORM DISPLAY-THE-FORM. 

035400 || 

035500 

035700 МАТМ-РАКТ. 

035900 

036000 MOVE SPACES ТО END-OF-JOB-IND. | 

036100 PERFORM PROCESS-THE-TERMINAL-DATA UNTIL END-OF-JOB. 

036200* FLUSH THE LINE 23 FIELD STILL BUFFERED UP 

036300 DISPLAY PROMPT-TERMINAL. 

036310 ACCEPT TERMINAL-DATA. | 

036320 DISPLAY PROMPT-TERMINAL. 

036330 ACCEPT TERMINAL-DATA. 

036400 CLOSE ТЕК-ЕОЕМ. 

036500 PERFORM TERMINAL-SET-DOWN. 

036600 STOP RUN. || 

036700% << LOGICAL END OF PROGRAM >> 

037000 PROCESS-THE-TERMINAL-DATA. 

037200% ------------------------- 

037200 | 

037300 MOVE SPACES ТО TERMINAL-DATA. 

037400 PERFORM GET-BUFFER-LINE. 

037500 

037600 MOVE SPACES TO LINE-IS-EMPTY-IND 1 

037700 PERFORM DISASSEMBLE-TERMINAL-INPUT UNTIL 

037800 LINE-IS-EMPTY O 
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037900 IF NOT END-OF-JOB 
038000 WRITE TEK-FORM-DATA 
038100 DISPLAY PROMPT-TERMINAL 
038200 MOVE SPACES TO TEK-FORM-DATA 
038300 DISPLAY PROMPT-TERMINAL 
038400 ELSE 
038500 NEXT SENTENCE. 
038600 DISPLAY '!ERA;!BEL'. 
038700* 
038800 — TERMINAL-SET-UP. 
039010* --------------- 
039000 
039120* IT IS BEST TO SET THE TERMINAL TO A KNOWN STATE 
039130* RATHER THAN TO ASSUME WHAT STATE IT IS IN. 
039100* SET PROMPT := <?><CARRIAGE-RETURN><LINE-FEED> 
039200% SET F1 := <CARRIAGE-RETURN><LINE-FEED> 
039300* SET PT :- «SEND MODIFIED» 
039400* SET FIELD-SEPERATOR := <CARRIAGE-RETURN> 
039500 
039600 DISPLAY '!PRO 63,13,10'. 
039700 DISPLAY '!LEA F1 13,10'. 
039800 DISPLAY '!LEA PT /!REP 1;!SEN MOD/13'. 
039900 DISPLAY '!FIE 13'. 
040000 
040200 TERMINAL-SET-DOWN. 
ОДО О аа кекете 
040400 
040500% PURPOSE: 
040600% 
040700% RETURN THE TERMINAL TO COMMUNICATION WITH THE HOST, 
040800* THE KEYBOARD TO THE MONITOR SPACE, NON-FORM FILL OUT, 
040900% UNBUFFERED, ALL FUNCTION AND OTHER KEYS UN-LEARNED, AND 
041000* DISPLAY IN THE MONITOR SPACE OF THE TERMINAL A MESSAGE SAYING 
041100% WHAT HAS BEEN DONE. 
041210* IN THIS WAY, IT IS POSSIBLE FOR THE USER TO COMMUNICATE 
041220% WITH THE COMPUTER WITHOUT LOSING THE LAST SCREEN. 
041200 
041300 DISPLAY '!FOR N;!BUF N;!MON K H'. 
041400 DISPLAY '!CLEAR'. 
041500 DISPLAY "<< END OF ТЕК FORM FILLOUT EXAMPLE >>". 
041600 
041800  GET-BUFFER-LINE. 
0518108. аи рак 
042000# SINCE INFORMATION IS 'BUFFERED' , ТТ IS NECESSARY ТО 
042010% 'PROMPT' THE TERMINAL TO SEND THE DATA AND THEN WAIT FOR IT TO 
042020* BE SENT. 
042300 
052400 DISPLAY PROMPT-TERMINAL. 
042500 ACCEPT TERMINAL-DATA. 
042510 
043000 DISASSEMBLE-TERMINAL-INPUT. 
ОПАО О о le 
043200 
043300% THIS SECTION IS А 'САЗЕ' STATEMENT THAT EXAMINES 
043400* THE DATA FROM THE TERMINAL AND PERFORMS A ROUTINE 
043500* WHICH FURTHER EXAMINES THE LINE. 
043600* 
043700* CASE TD-LOC-ROW OF 
043800* "1003" : PERFORM ROW 3 PROCESSING 
043900% '005' : PERFORM ROW 5 PROCESSING 
044100% "023" : PERFORM ROW 23 PROCESSING 
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044300% 
O44400* WHEN THE PROTECTED MODIFIED FIELD ОМ LINE 23 IS PROCESSED, EOL IS 
O44500* SET TRUE AND THE BUFFER CONSIDERED PROCESSED. THE WHOLE PROCESS 
O44600* STARTS OVER AGAIN AND A NEW BUFFER IS PROCESSED. 
O44700* 
O44800 IF TD-LOC-ROW = '003' 
044900 PERFORM ROW-3 
045000 
045100 ELSE IF TD-LOC-ROW = '005' 
045200 PERFORM ROW-5 
045210 
045220 ELSE ТЕ TD-LOC-ROW = "023! 
045230 PERFORM ROW-23. 
045300 
046800% NOTE: IF ADDITIONAL LINES EXIST ON THE FORM 
046900* ADDITIONAL 'ELSE ТЕ" LINES MAY BE CODED. 
047000% HOWEVER, THERE 15 A LIMIT TO THE DEPTH TO WHICH 
047100* MOST COMPILERS WILL ALLOW IF'S TO BE NESTED. 
047200* TO OVERCOME THE NESTING LIMIT, START UP AN- 
047300# OTHER 'IF...THEN...ELSE'. 
049800 
049900 IF LINE-IS-EMPTY 
050000 NEXT SENTENCE 
050200 ELSE PERFORM GET-BUFFER-LINE. 
050300 
050500* 
050600* WORK ROUTINES 
050700* 
050800* THESE ROUTINES FURTHER BREAK DOWN THE DATA JUST RECEIVED 
050900* FROM THE TERMINAL. EACH OF THE ROUTINES THAT FOLLOW 
051000* IS DEDICATED TO ONE ROW FROM THE TERMINAL. THESE ROUTINES WILL 
051100* EXAMINE THE COLUMN NUMBER AND TAKE APPROPRIATE ACTION. 
051200* IN THIS PROGRAM THE DATA IS JUST SAVED IN A DISK FILE 
051700* BUT ADDITIONAL PROCESSING COULD HAVE BEEN DONE. 
051800* 
051900 
052000X**xxxx 
052100 ROW-3. 
O5 22008 x xxxx 
052300 
052400 ТЕ TD-LOC-COL - "006" 
052500 MOVE TD-DATA TO TF-REF 
052600 
052700 ELSE ТЕ TD-LOC-COL = "025" 
052800 MOVE TD-DATA TO TF-CUST-1 
052900 
053000 ELSE IF TD-LOC-COL - '030' 
053100 MOVE TD-DATA TO TF-CUST-2 
053200 
053300 ELSE IF TD-LOC-COL - '053' 
053400 MOVE TD-DATA TO TF-INSTRUMENT 
053500 
053600 ELSE IF TD-LOC-COL - '071' 
053700 MOVE TD-DATA TO TF-VALUE 
053800 
053900 ELSE 
054000 NEXT SENTENCE. 
054100 
054200 ТЕ TF-REF = "QUIT! 
054300 MOVE 'EOL' ТО LINE-IS-EMPTY-IND 
054400 MOVE "ЕОЈ" ТО END-OF-JOB-IND 
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| 054500 ELSE 
054600 NEXT SENTENCE. 
054700 
054800**X**x**x 
n 054900 ROW-5. 
0550009 X 4 x 
055100 
055200 IF TD-LOC-COL = "011! 
n 055300 MOVE TD-DATA TO TF-TYPE 
055400 
055500 ELSE ТЕ TD-LOC-COL = "027" 
055600 MOVE TD-DATA ТО TF-FC-AMOUNT 
1 055700 
055800 ELSE ТЕ TD-LOC-COL = "048" 
055900 MOVE TD-DATA TO TF-RATE 
056000 
| 056100 ELSE IF TD-LOC-COL = "066" 
056200 MOVE TD-DATA TO TF-DOLLARS 
056300 
056400 ELSE 
1 056500 МЕХТ ЗЕМТЕМСЕ. 
056600 
056700%%%%%хх 
056800 ROW-7. 
056900****x** 
П 057100 ТЕ TD-LOC-COL = '012' 
057200 MOVE TD-DATA ТО TF-OUR-ACCT 
057300 
057400 ELSE IF TD-LOC-COL = "023" 
П бу 057500 MOVE TD-DATA ТО TF-CONTRACT-NR 
057600 
057700 ELSE IF TD-LOC-COL = '051' 
057800 MOVE TD-DATA TO TF-CREDIT-REFERENCE 
057900 
058000 ELSE IF TD-LOC-COL = "076" 
058100 MOVE TD-DATA TO TF-CHECK-OK 
058200 
1 058300 ELSE 
058400 NEXT SENTENCE. 
058500 
068100 
|| 068200%%%%% ххх 
068300 ROW-23. 
068400***xxx** 
068500 
П 068600 MOVE 'EOL' ТО LINE-IS-EMPTY-IND. 
068700 
068800 DISPLAY-THE-FORM. 
кри dcm 
1 071400 
071500 DISPLAY ТЕЕО-0. 
071600 DISPLAY ТЕЕО-1. 
071700 DISPLAY ТЕЕО-1А. 
1 071800 DISPLAY TFFO-1B. 
071900 DISPLAY TFFO-1C. 
072000 DISPLAY TFFO-3. 
072100 DISPLAY TFFO-3A. 
| 072200 DISPLAY ТЕЕО-ЗВ. 
072300 DISPLAY TFFO-3C. 
072400 DISPLAY TFFO-3D. 
1 072500 DISPLAY TFFO-3E. 
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072600 
072700 
072800 
072900 
073100 
073200 
073300 
073400 
075600 
075700* 
075800* 
075900 
076000* 


076100* << PHYSICAL END OF PROGRAM >> 


DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 


DISPLAY 


TFFO-5. 
TFFO-5A. 
TFFO-5B. 
TFFO-5C. 
TFFO-7. 
TFFO-7A. 
TFFO-7B. 
TFFO-7C. 
TFFO-EOD-FLAG. 


TFFO-END. 
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MEMORY CONSIDERATIONS 


It is possible for the terminal to use all of its display memory. Likewise, the terminal may 
use up all of its graphics memory. The comments in this appendix should help the 
programmer judge how much of each type of information can be sent to the terminal 
before running out of memory. 


DISPLAY MEMORY 


On the screen, a full line of text (a character displayed in every column) plus ten attribute 
codes uses 112 bytes (in the display list). A full screen of such lines (34 lines X 112 
bytes/line) uses about 3800 bytes. As a rule of thumb, then, you get about one full screen 
of display for every 4K bytes of display memory. Usually, of course, one does not use the 
full 80 columns of a line for display. A rough calculation of line length will give the proper 
adjustment factor. For example, if the program uses roughly 50% of each line for display, a 
16K byte display memory will store approximately: 


16K bytes x 1 screen x 2 = 8 34-line screens 
4K bytes 


The workspace and the monitor both use memory out of the same “роо!” of display 
memory. When the terminal has used most of its display memory and you attempt to 
display more information, the result depends on which scroll is receiving information. 


If the terminal runs low on memory while you are sending information to the workspace, 
the terminal bell rings as a warning to the operator, and the terminal overprints a portion 
of the current line with incoming data. If information continues to come, the terminal soon 
refuses to print and the cursor sticks at its current location. 


If the terminal runs low on memory while you are sending information to the monitor, the 
cursor simply sticks at its current location and the terminal refuses to print new 
information. The terminal still processes a carriage return, however, and enough memory 
is saved to give at least one command. (If the monitor has scrolled information up past the 
top of the monitor window, the terminal discards this information as needed, line by line. 
In this case, you may keep sending information to the monitor, and the terminal will keep 
discarding scrolled up information.) 
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MEMORY CONSIDERATIONS 


An applications program may keep track of the amount of unused display memory by 
occasionally giving the command 


"ВЕР 00« CR» 


This command causes the terminal to return a report to the computer in the following 
format: 


IANS 00,<р1>,<р2>; 


where <p1 > is a four-digit decimal number specifying the number of unused blocks of 
display memory. (A block consists of 16 8-bit bytes.) When <р1 > falls below a given 
level, the program can instruct the terminal to erase information by sending an ERASE, 
DLINE, or DCHAR command or, if the information displayed is not needed, a WORKSPACE 
or MONITOR command. To recover display memory from the computer, you must give 
some command which erases text. 


GRAPHICS MEMORY 


The terminal can contain 48K, 96K, 144K, or 192K bytes of graphics memory. The amount 
of graphics memory which a given graph requires depends on the density of information 

in the graph. The following is an estimate of how much graphics memory is required for 
graphic display. The term "pie chart" refers to a pie chart with 10 pieces. The term 

"graph" refers to a line graph of approximately the same density as the graph in Figure 8-8. 


Table F- 1 


GRAPHIC MEMORY CAPACITY 


Amount of Graphic Memory Display Capacity 
48K bytes 2+ pie charts, or 2 line graphs 
96K bytes 4 pie charts, or 3 to 4 line graphs 
144K bytes 6 pie charts, or 6 to 7 line graphs 
192K bytes 8 pie charts, or 7 to 8 line graphs 
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PROGRAMMER’S REFERENCE TABLE 


Please record the following settings for future reference: 


Transmitting Baud Rate TB= 
Receiving Baud Rate RB= 
Command Character СС= 
Prompt String PR= 
End-of-line String EL= 
Duplex (Full or Half) DU= 
Echo (Remote or Local) EC= 
Parity (None, Even, Odd, High, or Data) PA= 
Field Separator FS= 
End-of-File String EF= 


Send Key String 

Display Memory Capacity 
Graphics Memory Capacity 
Fonts Installed 


Options Installed 
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OPTION SUMMARY 


Option 1: Half Duplex 


Permits half duplex normal and supervisor modes in addition to the full duplex 
communications provided as standard equipment. 


Option 2: Current Loop 


Permits the 4027 to communicate with the host computer or another device by means of a 
20 mA current loop rather than the standard RS-232 interface. 


Option 3: RS-232 Peripheral Interface (Requires Option 36) 


Permits the 4027 to transmit to RS-232 compatible peripheral devices such as the 
Tektronix 4642 Printer. With this option, data from the host computer or the workspace 
can be printed on the 4642 Printer. Includes current loop board and L-bracket. 


Option 4: GPIB Peripheral Interface (Requires Option 36) 


Permits the 4027 to communicate with and control the Tektronix 4924 Digital Cartridge 
Tape Drive and 4662 Interactive Digital Plotter. These devices communicate with the 
4027 over the General Purpose Interface Bus (GPIB), which is defined in IEEE Standard 
488-1975. Allows the 4027 to save data or command files on the 4924, and retrieve them 
later without the need for intervention by the host computer. 


Option 10: Polling Interface (Includes Option 2) 


Permits the 4027 to function in a polling environment, as one of several display stations 
communicating with the host computer through a polling controller. (See Option 11.) 


Option 11: Polling Controller 


The Tektronix polling system permits multiple terminals to be connected to a single host 
communications port. The Polling Controller (Option 11) provides for control of up to eight 
additional display stations via a 20 mA current loop interface. Full duplex interface is 
provided at up to 4800 baud. 
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The Option 11 Polling Controller communicates with the host computer through an RS- 
232 port, using IBM 3271/3277 Bisynchronous EBCDIC protocol. 


In addition to the RS-232 port for communicating with the host and the current loop port 
for communicating with the display stations, the Option 11 Polling Controller includes a 
third communication port. This is an RS-232 transmit-only port for driving a printer. 
Options 21 and 22: Added Display Memory 

The standard 4027 includes 8192 bytes of display memory. (Each byte is 8 binary bits, 
and can hold one АЗСИ character.) Options 21 and 22 expand this, permitting larger 
quantities of text to be stored in the workspace and monitor. 


Option 21: A total of 16,384 (16K) bytes of display memory. 


Option 22: A total of 32,768 (82K) bytes of display memory. 


Options 27, 28, and 29: Color Graphics Memory 
Permits the 4027 to draw a variety of geometric shapes and panels in any of 64 possible 
colors. Solid lines and seven types of dashed lines can be drawn, and individual points 
can be plotted. Individual lines can be erased by drawing over them with “erase vectors.” 
In addition, the Graphics Memory options permit the user to create alternate character 
fonts for displaying text in the workspace, to create individual symbols and 120 user- 
defined patterns. 
These options differ only in the amount of graphics memory they include. Larger amounts 
of graphics memory permit the 4027 to perform more complex tasks in its workspace, and 
to create more alternate character sets. 

Option 27: 96K (total) bytes of graphics memory. 


Option 28: 144K (total) bytes of graphics memory. 


Option 29: 192K (total) bytes of graphics memory. 
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Option 31: Character Set Expansion. 


Permits the addition of ROMs (Read Only Memories) containing alternate character fonts. 


Option 32: Ruling Characters (Requires Option 31) 

Adds the “ruling” character font, permitting single and double lines to be drawn on forms 
in the workspace, as well as ruling junctions characters. 

Option 34: Math Characters (Requires Option 31) 


Adds a set of “math” characters to permit mathematical symbols to be displayed in the 
workspace. Includes standard mathematical symbols, Greek letters, and superscripts. 


Option 36: Peripherals ROM 


Provides instructions for the 4027 processor, allowing it to communicate with RS-232 or 
GPIB peripheral devices. (Required for Option 3 or Option 4.) 


Option 42: Hard Copy and Video Out 


Permits the 4027 to copy the contents of its workspace, monitor, or screen on a Tektronix 
4632 Hard Copy Unit. The copies are each about 8 1/2 by 11 inches in size, and can 
show 34 lines of the workspace or monitor contents. One or several 34-line pages may be 
copied. The copies can show rulings, special characters, and graphics, as well as 
ordinary text. 


Also permits the 4027 display to be viewed on a standard video monitor. 


Option 48: 220 Volt Power 


Enables the 4027 to operate from 220 volt 50 or 60 Hz power lines. 
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ROUTINE EXTERNAL CONVERGENCE BOARD 
ADJUSTMENTS 


Routine external convergence board adjustments should be made by 
qualified personnel only. 


The external convergence board may need to be adjusted occasionally. Convergence 
should be checked when the terminal is first installed or whenever it is relocated. 


Proper convergence means that the red, green, and blue beams come to a point on the 
screen. If the convergence is not properly adjusted, red, green, and blue colors will appear 
on the perimeter of any white areas on the screen. If convergence appears to be out of 
adjustment, the following procedure should be used to adjust the external convergence 
board. 


Procedure for Routine Convergence Adjustments 


1. Туре the CAL command (ICAL « CR»). 


This will cause a message to be displayed which assigns each of the function keys 
(F1 through F8) to a color and F9 to an alignment grid. Go through the function keys 
from F1 to F8 and check that the following colors appear: white, red, green, blue, 
yellow, cyan, magenta, and black. 


2. Remove the two screws securing the external convergence board tray and slide out 
the tray (Figure І-1). 


The external convergence board contains 27 adjustments arranged in groups of 
three. Looking at the board from the front of the terminal, there is a direct 
correspondence between each of these groups and an area on the screen. For 
example, upper left on the board corresponds to upper left on the screen. In addition, 
the adjustments are color coded. Thus, the red adjustments control the red beam, the 
green adjustments control the green beam, and the blue adjustments control the 
blue beam. 


Refer to Figure 1-1 for the direction of beam movement produced by the convergence 
adjustments. For a particular area, the red and green are converged first, then the 
blue is converged with them. 
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BEAM MOVEMENTS 
PRODUCED BY 
THE CONTROLS 


UPPER LEFT 
ON SCREEN 


че ie ! 
a — re 
EXTERNAL CONVERGENCE BOARD 
2658-11 


1-1. Adjusting the External Convergence Board. 


After the terminal has warmed up for 30 minutes, press the "degauss' button on the 
rear panel for 2 or 3 seconds. Press function key Е9 to display the alignment grid. 


Begin adjusting in the center (first the red and green, then the blue) and continue in 
the following order: top center, bottom center, right center, left center, top right, 
bottom right, top left and bottom left. 


Once satisfactory convergence has been obtained, restore the external convergence 
board to its compartment. 


@ 4027 PROGRAMMER'S 


Appendix J 


COMMAND LISTING 


Table J-1 


COMMAND LISTING 


Action 
Different in 
Discussed Options Form Fillout Other 
Command | оп Раде Required Mode Comments 

ALLOCATE 11-11 | 4 

ATTRIBUTE 9-10 Logical attributes | Workspace Only 

effective only in 
Form Fillout Mode 

BACKTAB 6-16, 9-23 X 

BAUD' | 51 3 | 
BELL 6-23 

BUFFERED 5-19 | 

CIRCLE 8-19 | 
CLEAR 1 4-9 

COLOR 7-2 

COMMAND 2-9, 5-2 

COPY 11-21 Зог 4 X 

DCHAR 10-1 X | 
DELAY 5-25 | 

DIRECTORY 8-38 

DISABLE 11-14 | 

DISCONNECT 8-6 1 | 
DFONT 5-31 

DLINE 10-6 X 

DOWN 6-8 

DUPLEX 5-29 1 

ECHO 5-17 T 
EOF 5-28 3or4 

EOL 5-21 

ENABLE 8-4 

ERASE (Workspace 6-22, 9-25 

and Monitor) E Х 

ERASE (Graphics) 8-26 | 
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Table J-1 (cont) 


COMMAND LISTING 


Action 
Different in 
Discussed Options Form Fillout Other 

Command on Page Required Mode Comments 
EXPAND 4-7 
FIELD 5-26, 9-29 
FONT 8-32 | 
ҒОНМ 5-10,9-3 
СВАРН!С 8-2 
GTEST 5-37 
HRULE 9-16 32 
ILINE 10-10 Бн X 
INK 8-22 
JUMP 6-2, 9-13, 9-26 Workspace only 
KILL 11-16 4 
LEARN 4-2, 4-7 LL —— 
LEFT 6-12 
LINE 8-11 
MAP 7-3 
MARGINS 5-7 | Workspace only 
MIX 7-7 p[——— p 7 
MONITOR Гр 1| ЕЕ | 
PARITY 5-15 
PASS 11-17 4 
PATTERN 7-8 


From the host only. 
Some forms require 


options. 


PERIPHERALS 

PIE 

POLY 8-12 

PROMPT 5-23 

REPORT 3-11,11-8 

RDOWN 6-20 | | 
RIGHT 6-10 

RMAP 7-5 

J-2 @ 
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Table Ј-1 (cont) 


COMMAND LISTING 


COMMAND LISTING 


Action 
Different in 
Discussed Options Form Fillout Other 
Command on Page Required Mode Comments 
RPOLY 8-14 
RUP = 19 
ЗЕМО = 3 9-27 X 
SET 11-2 Зог4 
SHRINK 8-28 
SNOOPY Е 了 
STOPS 
STRING = A [ 
SYMBOL 8-35 
SYSTAT 5-32 fF y 
TAB 6-14, 9-21 
TEST 5-35 ee || 
ОР 6-5 
VECTOR 8-7 
VRULE 9-17 32 | 
WORKSPACE 5-3 | 
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INDEX 
ALLOCATE боттапа .... ors se e eke rr mmm Rare menm Reda 11-11 
ANSWER: зи dnas |" celsa 3-11,11-8 
ASCII Code Спа ће с а sese ука саз ера оаа о аав ан бааа 8-1 
ASCII strings, delimited ............................................ 2-4 
АТТИІВШТЕФОШтатаь, өзенім болови веза ва GIA шт светол 9-10 
Attributes 
AIPNANU MEIC: ноды oe eR whee pres oe Sew were вена кекете дн Wale 9-7 
GOGB S „оле дъ с брава на 8-29, 9-9 
ПЕН ра тв наиме ау 9-6 
ТӨП захаа аеоси Раа Р АЕНА А 9-6, 9-11 
(ава ыы tore vier E E TEE конецот тайма token вата, дода баша баданалы тады 9-7,9-12 
ПО је озо дарды қа а қа ны и TETTE 9-7 
[еј под: тој (о йы ызы odas rua e rA И СОИ 9-7 
уједа асан са еден сы ернек а аи пла 9-8,9-12 
О Әке ид да ааа D vu de TS ери оно ее META 9-9 
BACKTAB: COMMANG? о ви атара нар тоа на тааз ао ДЫ 6-16, 9-23 
BAUD Согатапа: «3:2: p 0 toss || 5-13 
BEML СОАО. гасвир онаа онеки 6-23 
BUFFERED: Соттаћо езге ее еа m ва дара гата аала 5-9 
CIRCLE CGomimarido sun imas ұрады ыл мод ае пат ва 8-19 
CLEAR GOMMAN ааа Е еа ааваа а жаке» 4-9 
СОГОНСоттапа,.,................-------“-еә:е-ы-“маевема даа и 7-2 
Color 
DACKGKOUNG vile адан ама dep oe sel ee i м" 7-8,8-35,8-37 
воштавту а с съез ваља cea ата ова а Td ња ќи РАНЕНЫХ 7-2 
ТОГЕСТОШПС!), 2-2 omn eT CHOR и а бат тырды қо Ie с v eae M а 7-8,8-35,8-37 
CO 7-2 
Color Standard, Tektronix 4027 |a: eor soe erm а А-1 
COPY COMMANA. anno уља бонна cti rece che каналын ыл была тағанда 11-21 
COMMAND Соттапа ..2.222..5222:2-----......<--..-ешшшажав 2-9, 5-2 
Command, descriptions of вуліах........2...............2Ҙ.-.»..7.-. 2-6 
Command file, а!зрјаућпа........................................... 3-7 
Commands; fonmat.«ais299:samimdu mr qp ы е атта ата ғаты ыт. 2-2 
Commands, пуан. 2а imm eens tee sas ee Eada йыйын ease sagas 3-5 
COPYSWIICDGS cuoc cnau oriu A wel раса rio Bow ri 11-22 
еј поје На ооо оао КГ ет ЕРНІ meee ва 6-1, 8-4, 8-29 
E T E o EAE Е о 1-7, 6-1, 8-29 
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INDEX 


IDX-2 


DCHAR (Delete Character) Сотптапа............................... 8-29, 10-1 
DELAY соттап ;»%:556 63% cues ань Ена ааа је каје је ии 5-25 
DFONT ‘COMMANG оренда ини 8-38 
DISABLE Соттапа: «oia ceat e itat eR болама e екы ды ваа 8-6 
DISCONNECT Goimmatid... «iussit ptu аана ее TRE одана ач 5-31 
DIRECTORY Command ...... 2 emn RISIERIPOXChem мава тә кёз 11-14 
DisDIAy са гране sd wee rem am ehe e Bc ге ы mE eR ето обра a eat dd 1-2 
DLINE (Delete Line) Command ..................................... 8-29, 10-6 
ООММ СОМА: за ит сако ETAL Ьун а АЗРА 6-8 
DUPLEX COmmMan оса из Gin boa рента азы ра на 5-29 
ECHO! сотттапа ве оао аа ey teres аааз варад ене 5-17 
ENABLE боттапа ... omea accede fais CEPIT ER нан киви еве 8-4 
End апаје ааваа теле RR оаа ради Көнө сан анама 8-16, 8-19 
EOF (End-of-File) Command .. : „ааа жа жж, жзне. 5-28 
EOL. (End-of-Line) COMMANG еа ана агарат 5-21 
ERASE Command, workspace and топног.......................... 6-22, 9-25 
ERASE а Command «css resu аи арзан fca efe лели za одено 8-26 
EXPAND: Command) за: јава врбе га ара тын орлы 4-7 
FIELD Сбттапа: 52% Prom ce yg елдин» et 0 RE roe Бора О 5-26 
Field attiBute сода «s cea qi oderint s uim ааа аға E em ct ne 9-6 
Fields 

creatitid with JUMP. села red ж екл t tam rte etm ti s 9-13 

Form Fillout MOQO s+ cius вил әт GC ERIT ии ына ви Ha 9-29 

unprotected... cc sed eese em rem rem meia а аталын bra e aes 9-30 
FONT Соптана «32:2 29) X6 atc t Dé reet a tmm tentent i ee лаје НЫ 8-37 
Forts, alternate Character s a.u ore m mer nm rrt оын жама өлем 8-34 
FORM Сеттапа „ааа нана IRImRIe ISI RIA EIE ES 5-10, 9-3 
FORM, CUBE. ssa серый to сија nri cato еи reme елен Rec? ERR E 9-4 
БОПТИЕШӨШ MOOS assert нба DA зао BE нна a dedica 9-1, 9-20 
Foris, TRANnSMINING какоето ааа meme еккен етектен 9-27,9-30 
GIN (Graphic input) Moda... orsi octo meme emm кик виши 8-4 
ставе Beati... „аана rui Iq ава ЕН EE E 8-4, 8-32 
GRAPHIC! Commando «inier memet та Y ers ESTY 8-2 
Graphic region 

coordinate system. .....--..--2-:----5--25%4 PPP SS ты IEEE US 8-2 
Graphic 

СОО акр өт екы ҰМ а енеке resp Ско Rane алма ГЕТ. 8-1 

ШӨБІ; сектант ен БЫ кй кибе кш КЕША Е-2 

4010-S9tyl& sce oa нама анна НЕЕ 8-32 
(а БЕЗТ Сота кы» тш tad leri wea EE Eure чи патака 5-37 
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НСОРУ (Нага Сору) Соттапа............................ 
HRULE (Horizontal Rule) Соттапа........................ 
Ние ANGIE: aside er d т» сврти же ваза али тата es 


ICHAR (Insert Character) Соттапа ....................... 
ІШМЕ (Insert Line) Соттапад.............................. 
INK COMMANG сезшен аа оо на и жанатын eae es 
INCrEMCNUANGIS ересь ооо о о eas ъв EE es 
именпасезлорпота! «2o: tr vite ia аа Rex Cosa 


Key deftinitlons, Сівагіпд-..р222-.-222.2-ХҘХ..хш....а ы. даа 
Key Progra ти то sese а: веб A ETE E еф ње EY UR 
кеуббака «ism edet рым каны енды rare desit 


Кеуз 


LEARN Соттапо о. с етику оао еее таев бетен 
LEFT COMmMMand ТИТРІ 
LINE CORTAM алата мир ниви гово воочат ди 
теі а-г ограбена ева падови вни inis EY aed бера» 


Метогу 


СОАУ ДРИНИ аа аара и кен a 
grap MiO as ueris dopo Si ree a d тына РУДА ЫЛЛЫЫ лана 
MIX Commarid. usse uu оао IRI CUIRE ва пе завои 


Numeric Parameters)... iesu cure сетио ces аз вилите а TAS 


PAD Gomrnand, со а cana memo ra ULP PIE Yes ынты Е 


PARITY Соттапа. i orbelmleschbrHÉTOIEODRIEGInimeiscsga 
PASS Соттана алати свиња сара намы във ан а ат 


Peripherals Data List. io. educ re нек поља кагана вв ETE VOS 
Peripherals supported , азота сване ваљка ние иены 
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PIE боттапа с sientes hers RA tas OR ATS акта ад 8-16 
Plotter Language Соттапаѕ....................................... 11-18 
С | Паје = ао ин банана заказ T Sir Et пра атын es ен H-1 
POLYGON Command «iw ааа а се коцки E ES EE eU 8-12 
PROMPT Соттапа «cease mec eem mde адан а d ae’ 5-23 
Raster ил ос ама газе и назва ма ра Eden абе кама ели qs an 8-16 
RDOWN (Roll Down) Соттапа..................................... 6-20 
REPORT Соттапа. xx uoroeesr аьа аак сате T ESAE Re lod 3-11,11-8 
RGB (Весі-бгееп-Вше)............................................ 7-7 
RIGHT Commando seus dcn ocn dct e atr ern o каны e aot pee s 6-10 
AMAP Соттапй -ceio а ынаа DEEST E ESTA 7-5 
ROM GhHECKSUMS «xao оао RE va ken me dant acere eere тыңбай 5-35 
RPOLYGON (Relative Polygon) Соттапа........................... 8-14 
RülifidS са а а а вета а ари ава рана A ar dp ecd e ER 9-16 
RUP (Roll Up) Соттапа........................................... 6-18 
RVECTOR (Relative Vector) Соттапа.............................. 8-9 
Зашганой. на ақсары вена MESE e RE REG 7-3, 7-5 
БОРО ТО ашса аза те ја келед рыда (арыл разво ќа Төбе Колор wi eye туа 6-18 
SEND Сбттапа usada vadum yip екен сва ава жазура 3-8, 8-29, 9-27 
SET Command ава не љуто вата иаа на ааа 11-2 
SHRINK Command ....... ert oda онла i рани «ара Ела 8-28 
SNOOPY Соттапа ооо ықы da wd виа 5-11 
Split SGre iss: ots лета ER оао d eoe o ele 1-5 
Start anglB ace oad ees ed rando e e ouo ов mated Lands hacky eS opted 8-16, 8-19 
Status теззадез:. ive denn ad басы т ақтара Hare toh eim due а ааа 5-32 
STOPS COmMMANG прок no sidus ear ved іы кик атында e vert 5-9 
STRING Gommatid..« «udis qd rete v da se xm асты е ы иа йк а аш ELEM 8-24 
Switches; GORY э. 22220444 chess енен ед ле smal RR 11-22 
SYMBOL; Goiimand..i5 dcs hdc cera еа оа DER ER ива ивана 8-35 
SYSTAT (System Status) message ................................. 5-32 
TAB Command г;:2555%5652 у қы exar кен ух Айй ase 6-14, 9-21 
ТЕӘПІСОтШАП е бет np DP qun drm аа о ы Ей 5-35 
техрапа ‘COMMANGS аза срна ја риа атайын те Ра 3-1 
UP СОШПШАПй,,,::5%%%5 695% ска SINI жа wa b da аа наи нь 6-5 
УЕСТОР COMMA «аел анаан н етан Ве 8-7 
Vector LINE DOS „ае в hie omes із ооо натан Ева ава 8-11 
Visual enhancements (айгірџиќеѕ)................................... 9-8, 9-12 
VRULE (Vertical Rule) Соттапа................................... 9-17 
WOFKSDSCO. ionis ihe En PAc d еб са ab aan Gor de ръба вана аи 1-5 
WORKSPACE Command са ава тако ван и іе Рене тейе ле те Ы os 5-3 
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